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PREFACE 



This document describes the purpose and the use of the ICE-86A In-Circuit 
Emulator for the Intel 8086 microprocessor. 

The ICE-86A module is an optional addition to the Intellec Microcomputer 
Development System. The ICE-86A module aids in testing and modification of the 
hardware and software for new products designed around the 8086 microprocessor. 

Chapter 1 describes the mission of the ICE-86A emulator as a development aid for 
system designs based on Intel's iAPX-86 microprocessor. 

Chapter 2 gives step-by-step instructions for installing the ICE-86A hardware in the 
Intellec chassis and connecting the ICE-86A emulator to the user prototype system. 

Chapter 3 presents a hands-on debugging session with the ICE-86A emulator. 

Chapter 4 describes the elements of the ICE-86A command language, the notation, 
conventions, and the syntactic rules used in this manual. 

Chapter 5 defines the operands, operators, and expressions used in the ICE-86A 
commands. 

Chapter 6 contains discussions and specifications of the emulation and trace control 
commands. 

Chapter 7 contains discussions and specifications of the interrogation and utility 
commands. 

Chapter 8 contains discussions and specifications of the compound and macro com- 
mands used in the ICE-86A emulator. 

Appendix A is a list of all ICE-86A keywords (literals), and their abbreviations, in 
alphabetical order. 

Appendix B is a list of ICE-86A error and warning messages with interpretations. 

Appendix C contains a syntactic summary of the ICE-86A commands. 

Appendix D presents the electrical and physical characteristics of the ICE-86A 
emulator. 

Appendix E presents the 8086 assembler instructions in hexadecimal order. 

Appendix F contains the iSBC 86/12 and iSBC 86/12A fix. 

Appendix G explains the use of the CLOCK, RDY, and RWTIMEOUT. 

Appendix H provides installation procedures for the ICE-86 upgrade. 

Appendix I explains the use of the Floating Point Macros with the ICE-86A 
emulator. 

Appendix J contains schematic drawings for reference. 
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To use this manual effectively, you need to understand the 8086 architecture and 
techniques of programming and debugging. The following publications contain 
detailed information related to this manual: 



ISIS-II User's Guide 9800306 

8080/8085 Assembly Language Programming Manual 980030 1 

ISIS-II 8080/8085 Macro Assembler Operator's Manual 9800292 

A Guide To Intellee Microcomputer Development Systems 9800558 

The 8086 Family User's Manual 9800722 

8086 Family Utilities Users Guide 9800639 

The 8086 Family User's Manual Numerics Supplement 121586 

8086/8087/8088 Macro Assembly Language Reference Manual 1 21623 

8086/8087/8088 Macro Assembler Operating Instructions 1 2 1 624 

PL/M-86 User's Guide 121636 
8089 Real-Time Breakpoint Facility Operating Instructions for 

ICE-86A/88A In-Circuit Emulator Users 162490 

A complete list of publications for use with the Intellee Series III Microcomputer 
Development System is provided in the following manual: 

Intellee Series III Microcomputer Development System Product 

Overview 121575 
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CHAPTER 1 
INTRODUCTION TO THE 
ICE-86A™ EMULATOR 



This manual presents the operation of the In-Circuit Emulator for the Intel 8086 
microprocessor, or ICE-86A emulator. As an introduction to the use of this 
microprocessor design aid, this chapter contains an overview of the product and its 
relationship to other products and contains a brief discussion of integrated 
hardware/software development, in-circuit emulation, and ICE-86A architecture. 
Also a generalized development cycle with the ICE-86A emulator and a generalized 
1CE-86A emulation session are presented. 



ICE-86A In-Circuit Emulator 

The 1CE-86A emulator provides in-circuit emulation for 8086 microprocessor-based 
systems. Figure 1-1 shows the functional block diagram of the 8086 CPU. The 
ICE-86A module consists of three circuit boards which reside in the Intellec Micro- 
computer Development System. A cable and buffer box connect the Intellec to the 
user system by replacing the user's 8086. In this manner the Intellec debug functions 
are extended into the user system. Using the ICE-86A module, the designer can 
execute prototype software in continuous or single-step mode and can substitute 
Intellec equivalents for user devices, such as memory. 
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The 8086 CPU can be used with the 8087 NDP (Numeric Data Processor) and/or 
with the 8089 IOP (Input/Output Processor). The 8087 NDP is capable of expand- 
ing the 8086 CPU's arithmetic abilities to include floating point calculations. (See 
The 8086 Family User's Manual Numerics Supplement, Manual Order Number 
121586, for information on the use of the 8087 NDP as a coprocessor.) 

The ICE-86A emulator provides extended capabilities to allow debugging of systems 
using the 8086 CPU with the 8087 NDP. Coprocessor debugging is aided by the 
following ICE-86A features: 

• Three real number types for memory content references 

• Four external buffer box signals to aid in coordinating the user system with the 
ICE-86A emulator 

• RQGT and BUS commands for the operation of the 8086 RQGT lines 

• DASM and DEFINE DASM commands for disassembling 8087 instructions 

• Emulation timer for optimizing coprocessor code 

The 8089 IOP allows for more efficient handling of processor I/O. (See The 8086 
Family User's Manual, Manual Order Number 9800722, for information on the use 
of the 8089 IOP.) 

The 8089 Real-Time Breakpoint Facility (RBF-89) is a software superset of the 
ICE-86 emulator Version 1.2, a previous 8086 emulator. RBF-89 includes most of 
the ICE-86A features (see below for exceptions) plus the following features that aid 
in designing systems based on an 8086 CPU used with an 8089 IOP: 

• Commands to initialize the 8089 IOP 

• Commands to control program execution on the 8089 IOP 

• Commands to disassemble 8089 instructions 

RBF-89 software runs on ICE-86 or ICE-86A hardware but does not include the 
following ICE-86A features: 

• External buffer bus signals are not available. 

• ENABLE/DISABLE SYMBOLICALLY commands are not available. 

• DASM and DEFINE DASM for disassembling 8087 instructions commands are 
not available. 

• ENABLE/DISABLE EXPANSION commands are not available. 

• The SELECTING modifier for the LOAD command is not available. 

• The one-byte CAUSE register is returned rather than the string associated with 
various conditions. 

• The three real number types (REAL, DREAL, and TREAL) are not available. 

See 8089 Real-Time Breakpoint Facility Operating Instructions for ICE-86 A/ 88 A 
In-Circuit Emulator Users, Manual Order Number 162490, for instructions on the 
use of RBF-89. 



The ICE-86 and ICE-86A Emulators 

The following features are supported in the ICE-86A emulator (Version 2.0), but are 
not included in the ICE-86 emulator (Version 1.2), the previous 8086 emulator: 

• RQGT lines 

• External control of emulation 

• A hardware reset signal to the user system 
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• A signal indicating emulation status 

• A signal indicating when a breakpoint condition has been met 

• ENABLE/DISABLE SYMBOLICALLY commands 

• RQGT and BUS commands 

• DASM and DEFINE DASM commands 

• ENABLE/DISABLE EXPANSION commands 

• The SELECTING modifier for the LOAD command 

• A string is returned from the display of the CAUSE register 

• Three real data types (REAL, DREAL, and TREAL) 

1CE-86 emulator (Version 1 .2) users consulting this manual for operating instruc- 
tions should note the differences listed above. When reading this manual, ICE-86 
emulator (Version 1 .2) users should keep in mind that these enhanced features only 
work with the ICE-86A emulator (Version 2.0). 

Additionally, some users may wish to run the ICE-86A (Version 2.0) software on 
ICE-86 (Version 1.2) hardware, for example, before they have upgraded their 
ICE-86 (Version 1 .2) hardware. 

The following features require the ICE-86A hardware and are not supported in a 
configuration using ICE-86 hardware with ICE-86A software: 

• RQGT lines 

• External control of emulation break 

• A hardware reset signal for the user system 

• A signal indicating emulation status 

• A signal indicating when a breakpoint condition has been met 

• RQGT and BUS commands 

• DASM and DEFINE DASM commands 



Integrated Hardware/Software Development 

The ICE-86A emulator allows hardware and software development to proceed con- 
currently. This is more effective than the traditional method of independent hard- 
ware and software development followed by a system integration phase. With the 
ICE-86A emulator, prototype hardware can be added to the system as it is designed. 
The software and hardware can be used to test each other as the product is 
developed. 

Conceptually, the ICE-86A emulator can be viewed as assisting three stages of 
development: 

1. The ICE-86A emulator can be operated without being connected to the user's 
system, so its debugging capabilities can be used to facilitate software develop- 
ment before any of the user's hardware is available. 

2. To begin integration of software and hardware development efforts, the user's 
prototype need consist of no more than an 8086 CPU socket. Through ICE-86A 
mapping capabilities, Intellec system equivalents (such as Intellec memory) can 
be substituted for missing prototype hardware. As each section of the user's 
hardware is completed, it can be added to the prototype, replacing the Intellec 
equivalent. Thus each section of the hardware and software can be "system" 
tested as it becomes available. 
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3. When the user's prototype is complete, it can be tested using the system 
software which will drive the final product. The ICE-86A emulator can be used 
for real time emulation of the 8086 to debug the system as a complete unit. 

Thus the ICE-86A emulator provides the user with the ability to debug a prototype 
or production system at any stage in its development without introducing extraneous 
hardware or software test tools. 

ICE-86A In-Circuit Emulation 

The ICE-86A In-Circuit Emulator is a diagnostic tool that is used for testing and 
debugging the hardware and software of user-designed 8086 microcomputer-based 
systems. Such testing may begin during the early phases of user system development 
and may continue throughout the life cycle of the user's system. 

The interface between the in-circuit emulator and the user system is implemented at 
the connector pins of the user system microprocessor chip. These pins carry the 
information that establishes the characteristics and status of the user system. The 
interface makes it possible for the in-circuit emulator to continually monitor user 
operations and to provide control of these operations. More specifically, the 
in-circuit emulator monitors execution of the user program and controls the condi- 
tions under which the user program execution is initiated and terminated. 

User Program Execution Control 

Starting and stopping execution of the user program at predefined points or condi- 
tions is an essential task of the in-circuit emulator as it is often not feasible or 
desirable to execute the entire user program. For example, a single routine may be 
executed because either other routines have not yet been coded or because a fault 
(bug) has been isolated to that routine. 

The starting address for execution is readily established by loading a known value 
into the program counter of the user processor while the processor is inactive. Ter- 
mination of execution is a more involved procedure which requires the in-circuit 
emulator to halt the processor when a predetermined multi-condition state exists at 
the 8086 pins. This process requires prior storage of state values within the in-circuit 
emulator hardware and dynamic comparison of these values with the states of 
specified data, address and/or status pins of the processor. The point at which the 
user program execution is terminated is known as the breakpoint. 

A breakpoint may be specified to cause the user program to halt execution when a 
given memory location is addressed during a processor fetch (i.e., loaded into the 
8086 execution queue). However, very often the operator is more interested in the 
data value of a memory location or an I/O port. In the latter cases both the type of 
instruction (read, write, input, or output) and the data value are prespecif ied and are 
dynamically compared with the processor pin states. It is also possible to specify 
4 'don't care" comparisons with the data pins and thereby halt execution whenever 
the designated type of instruction is extracted from the queue for execution. 

A wide range of breakpoint conditions are possible through comparison of the pro- 
cessor chip states with predesignated values. The full range of breakpoint conditions 
that may be specified by the operator are presented in subsequent chapters. 

Memory Mapping 

Memory for the user system can be resident in the user system or "borrowed" from 
the Intellec system through ICE-86A's mapping capability. 
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The 1CE-86A emulator allows 1 megabyte of user memory to be addressed by the 
8086. This user memory space consists of 1024 IK byte segments that can be mapped 
in IK blocks to: 

1 . Physical memory in the user's system, 

2. Either of two IK blocks of ICE-86A high speed memory, 

3. Intellec expansion memory, 

4. A random access diskette file. 

The first 64K of Intellec RAM memory is dedicated to Intellec system software. 
Therefore the RAM boards within the Intellec system that are used by the ICE-86A 
emulator to store the user program employ effective addresses beyond the 64K byte 
memory accessible to Intellec system software. 

Mapping consists of specifying where each "logical* ' memory block that the 8086 
addresses will physically exist within various physical memories. During emulation 
the memory map is used to determine the existence and physical location of the 
logical memory space being referenced by the user program. 

If a logical segment of addresses is not activated by associating the segment with a 
physical memory, the segment is "guarded." A guarded segment is logically non- 
existent and any reference to the segment by the user program results in an error. 
Thus the ICE-86A emulator can trap memory accesses outside the intended memory 
for program and data. All blocks are initially guarded following system reset and 
any segment may be guarded on command after its initial activation. 

Mapping enables the user to allocate segments of user memory space to physical 
memories other than the RAM/ROM of the user system. This feature permits 
testing of the user program prior to installation of user memory and also provides a 
convenient means of executing modified code in "borrowed" memory while the 
bulk of user program is resident within the user system. 



Symbolic Debugging 

Symbols and PL/M statement numbers may be substituted for numeric values in 
any of the ICE-86A commands. This allows the user to make symbolic references to 
I/O ports, memory addresses, and data in a user program. Thus the user need not 
search listings for addresses of variables or program subroutines. 

Symbols can be used to reference variables, procedures, program labels, and source 
statements. Thus a variable can be displayed or changed by referring to it by name 
rather than by its absolute location in memory. Using symbols for statement labels, 
program labels, and procedure names allows the user to set breakpoints or disassem- 
ble a section of code into its assembly mnemonics much more easily. 

Furthermore, each symbol may have associated with it one of the types BYTE, 
WORD, INTEGER, SINTEGER (for short, 8-bit integer), POINTER, REAL, 
DREAL, or TREAL. Thus when the user examines or modifies a variable from the 
source program, he doesn't need to remember its type. For example, the command 
"!VAR" displays the value in memory of variable VAR in a format appropriate to 
its type, while the command "!VAR= !VAR1" assigns the value of VAR1 to VAR. 

The user symbol table generated along with the object file during a PL/M-86 com- 
pilation or by the 8086 Assembler is loaded into the ICE-86A emulator along with 
the user program which is to be emulated. The user may add to this symbol table any 
additional symbolic values for memory addresses, constants, or variables that are 
found to be useful during system debugging. 
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In addition, the ICE-86A emulator provides access to all the 8086 registers and flags 
through mnemonic reference. The READY, NMI, TEST, HOLD, RESET, INTR, 
and MN/MX pins can also be read. 



Display 

Three basic types of data are available for display: trace data, 8086 termination con- 
ditions, and test parameters. Trace data is collected from the 8086 pins during execu- 
tion of the user program. Trace data collection can be continuous or selective. 
Tracepoints allow the user to selectively turn trace off and on as desired during 
emulation. The tracepoints are stored by the ICE-86A hardware on command prior 
to emulation. If trace data collected exceeds the capacity of the trace buffer, the 
older trace data is overwritten by current data. Trace buffer pointers entered by the 
operator permit selection of the trace information for display. 

The 8086 termination conditions are the status values of the 8086 processor that are 
accessible following termination of user program execution. The 8086 termination 
conditions include the values of registers, flags, input pins, I/O ports, status 
information, and the contents of the logical user memory space locations currently 
activated by the memory map. Some of this information is the same as that collected 
in the trace buffer. All 8086 termination conditions are displayed by console entry of 
the memory or port address or the name of the register, flag, or input pin. 

Hardware resident test parameters are entered by the operator and stored within the 
ICE-86A hardware. Such information includes breakpoints, tracepoints, the 
memory map, and the tracepointer used for control of trace data display. The 
operator displays this information to verify the correct entry or to determine the 
values of test parameters that were previously entered. 

Software resident test parameters are entered by the operator and stored within 
1CE-86A software. These parameters are used to establish values that effect hard- 
ware only upon entry of other commands. For example the symbol manipulation 
commands establish the relationship between the object code of the user program 
and symbols, statement numbers, and module names that are used by the operator 
to reference the user program code and data symbolically. 



Operating Modes 

The ICE-86A software is a development system-based program which provides the 
user with easy-to-use commands for defining breakpoints, initiating emulation, and 
interrogating and altering user status recorded during emulation. The ICE-86A com- 
mands are configured with a broad range of modifiers which provide the user with 
maximum flexibility in describing the operation to be performed. 

There are two distinct phases of operation when the ICE-86A emulator is used for 
debugging. The interval when the user program is being executed is referred to as the 
emulation phase. The interval when the operator establishes and modifies test 
parameters and displays (or prints) test results is the interrogation phase. 



Emulation 

Emulation commands to the ICE-86A emulator control the process of setting up and 
running an emulation of the user's program and examining the results of the emula- 
tion. Breakpoints and tracepoints enable the ICE-86A emulator to halt and provide 
a detailed trace in any part of the user's program. A summary of the emulation com- 
mands is shown in table 1-1 . 
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Table 1-1 . Summary of ICE-86A™ Emulation Commands 



Command 


Description 


GO 


Initializes emulation and allows the user to specify the 
starting point and breakpoints. Example: 

r±f\ CDOM QTADTTII 1 HCI AV CYCfllTCn 

vaU rriUlvi .0 1 An 1 1 ILL. UfcLAY fcAfcL»U 1 tU 

wnere o i ah i and ucLAt are statement labels. 


STEP 


Allows the user to single-step through the program. 


GR 


Sets the GO-register to a set of one or more breakpoint 
conditions or causes the display of the current 
GO-register settings. 


tNADLt/UioAbLt 1 HAUL 


Turn trace data collection on or off. 


TRACE 


Set trace display mode to display trace data in frame or 
instruction format or display current trace display 
mode. 


OLDEST 


Move trace buffer pointer to top of trace buffer. 


NEWEST 


Move trace buffer pointer to bottom of trace buffer. 


MOVE 


Move trace buffer pointer forward or backwards in 
buffer a specified number or buffer entries. 


DDIMT 


Display one or more entries from the trace data buffer. 


CLOCK 


Specify system clock as internal (ICE emulator 
provided) or external (user-provided) or cause current 
clock setting to be displayed. 


RWTIMEOUT 


Allows the user to time out READ/WRITE command 
signals based on the time taken by the 8086 to access 
expansion Intellec memory or disk-based memory. 


ENABLE/DISABLE RDY 


Allows the user to enable or disable the user-ready 
signal for accessing Intellec resident memory or disk 
memory. 



Breakpoints— the ICE-86A emulator has two breakpoint registers which allow the 
user to halt emulation when a specified condition is met. The breakpoint registers 
may be set up as execution or non-execution breakpoints. An execution breakpoint 
consists of a single address which causes a break whenever the 8086 executes an 
instruction byte which was obtained from that address. A non-execution breakpoint 
causes an emulation break when a specified condition other than an instruction exe- 
cution occurs. This condition can contain up to four parts: 

1 . A set of address values, 

2. A particular status of the 8086 bus (one or more of memory or I/O read or 
write, instruction fetch, halt, or interrupt acknowledge), 

3 . A set of data values, 

4. A segment register (break occurs when the register is used in an effective address 
calculation). 

Break on a set of address values has three capabilities: 

1 . To break on a single address. 

2. To set any number of breakpoints within a limited range (1024 bytes beginning 
at an even address) of memory. 
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3. To break in an unlimited range. Execution is halted on any memory access to an 
address greater than or equal to (or less than or equal to) the breakpoint. 

An external break input exists at the buffer box. It causes a break when a high to low 
transition occurs. An external breakpoint match output for user access is provided 
on the buffer, which allows synchronization of other test equipment when a break 
occurs. 

Tracepoints— the ICE-86A emulator has two tracepoint registers which establish 
match conditions to conditionally start and stop trace collection. The trace informa- 
tion is gathered at least twice per bus cycle, first when the address signals are valid 
and second when the data signals are valid. Trace information is also collected each 
CPU cycle during which the execution queue is active. 

Each trace frame contains the 20 address/data line values and detailed information 
on the status of the 8086. The trace memory can store up to 1023 frames, or an 
average of about 300 bus cycles, of trace data. The trace memory contains the last 
1023 frames of trace data collected, even if this spans several separate emulations. 
The user has the option of displaying each frame of the trace data or displaying by 
instruction in actual 8086 Assembler mnemonics. The trace data is always available 
after an emulation. 

Interrogation and Utility 

Interrogation and utility commands give the user convenient access to detailed 
information about the program and the state of the 8086 which is useful in debug- 
ging hardware and software. Changes can be made in both user program memory 
and the state of the 8086. Commands are also provided for various utility operations 
such as loading and saving program files, defining symbols and macros, setting up 
the memory map, and returning control to ISIS-II. A summary of the basic inter- 
rogation and utility commands is shown in table 1-2. 

During the Interrogation and Utility mode, the ICE-86A emulation processor will 
not respond to an NMI or RESET signal generated by the user system. However, it 
will respond to RQGT and HOLD signals from the user system. 



Table 1-2. Summary of Basic ICE-86A™ Interrogation and Utility Commands 



Command 


Description 


Memory/ Register Commands 


Display or change the contents of: 

• Memory 

• 8086 Registers 

• ICE-86A Pseudo-Registers 

• 8086 Status flags 

• 8086 Input pins 

• 8086 I/O ports 


Memory Mapping Commands 


Display, declare, set, or reset the ICE-86A memory 
mapping. 


DASM 


Disassembles the memory into 8086 assembler 
mnemonics. 


LOAD 


Fetches user symbol table and object code from the 
input file. 


SAVE 


Sends user symbol table and object code to the output 
file. 


LIST 


Sends a copy of all output (including prompts, input 
line echos, and error messages) to the chosen output 
device (e.g., disk, printer) as well as the console. 


EVALUATE 


Displays the value of an expression in binary, octal, 
decimal, hexadecimal , and ASCII. 
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Table 1-2. (Cont'd.) 



Command 



Description 



RQGT 

BUS 
CAUSE 
DEFINE DASM 

Symbol Manipulation Commands 



TYPE 

SUFFIX/BASE 



Sets or displays the status of the Request/Grant 
facility which enables the ICE-86A emulator to share 
the system bus with coprocessors. 

Displays which device is currently master of the 
system bus. 

Displays a mnemonic indicating the cause of the most 
recent emulation halt. 

Informs the ICE-86A emulator of the configuration of 
the user system; i.e., whether the 8087 chip or the 8087 
emulator exists. 

These commands allow the user to: 

Display any or all symbols, program modules, and pro- 
gram line numbers and their associated values (loca- 
tions in memory). 

Set the domain (choose the particular program 
module) for the line numbers. 

Define new symbols as they are needed in debugging. 

Remove any or all symbols, modules, and program 
statements. 

Change the value or type of any symbol. 

Enable or disable symbolic display. 

Assigns or changes the type of any symbol in the 
symbol table. 

Establishes the default base for numeric values in 
input text/output display (binary, octal, decimal, or 
hexadecimal). 



Macro and Compound Commands 

The ICE-86A software allows the user to program the operation of the ICE-86A 
hardware by using macros and compound commands. 

A macro consists of a set of ICE-86A commands with up to ten command 
parameters and is typically used to perform any task that is required frequently. 
Commands are provided to define, display, and delete macros, to invoke macros 
with an optional list of arguments, and to save macros in a diskette file or to load 
previously created macros from a diskette file. 

As an example, the following macro may be used to emulate a user program from a 
start address until a breakpoint is encountered, then to continue until a condition is 
satisfied: 



DEFINE MACRO GO 
IP = OFFSET %0 
CS = SEGMENT %0 
REPEAT 

GO TILL %1 
•DISPLAY 



UNTIL %2 
ENDR 



;DISPLACEMENT OF START ADDRESS 
;BASE OF START ADDRESS 

; EMU LATE TO BREAKPOINT 
; INVOKE MACRO TO DISPLAY 

VARIABLES OF INTEREST 
'CONTIN UE UNTIL SOME CON DITION 



EM 



:GO .START, #20 EXECUTED OR .A LEN 1GT READ, 'FLAG = 0 
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The symbols START, A, FLAG, and #20 are from the user program. 

The last line invokes macro GO, causing emulation to begin at label START, to 
break whenever statement #20 is executed or any element of a 10-byte array A is 
read, and then to continue unless the variable FLAG has a value of zero. 

Compound commands are control structures to either conditionally execute other 
commands (IF), or to execute other commands until some condition is met or the 
commands have been executed a certain number of times (COUNT, REPEAT). 

For example, the following compound command is used to repeat a set of com- 
mands until a condition is met: 

IP = OFFSET .START ;DISPLACEMENT OF START ADDRESS 

CS = SEGMENT .START ;BASE OF START ADDRESS 



In this command the condition IP = 1000H is tested every STEP. If the sequence of 
STEPs reaches IP = 1000H, the loop will terminate. 



This section contains a brief description of the software, firmware and hardware 
that compose the ICE-86A emulator. The information serves as an introduction to 
more detailed information presented in the remaining chapters of this manual. 

ICE-86A Software 

The ICE-86A software together with ISIS-II and the user program symbol table is 
resident within the 64K byte memory of the Intellec system. None of this space is 
available to user program code. User program address space mapped to Intellec 
resides in RAM boards (i.e., extended Intellec memory) whose physical addresses 
are above the reserved 64K byte address range. 

The functions performed by the ICE-86A software are dependent on the ICE-86A 
operating mode. In the interrogation mode, the ICE-86A software provides, 
arithmetic and logical conversions as necessary to establish compatibility between 
the ICE-86A hardware and the operator. This task includes conversion of operator 
commands to a form usable by the firmware and the evaluation of symbolic entries 
as necessary to provide absolute address and data values to the hardware. The 
ICE-86A software also reconverts hardware supplied information (trace data, error 
codes, map data, etc.) to forms that are meaningful to the operator. In the emula- 
tion mode, the ICE-86A software supports the accessing of user code from the 
diskette. In this mode the software also terminates emulation when directed by the 
hardware (breakpoint) or the operator (ESCape key) . 

Firmware commands are hardware related commands that are sent to the ICE-86A 
firmware to initiate a specific action. In general, each ICE-86A (operator-entered) 
command is an element of higher level language that is converted to a specific series 
of lower level firmware commands (assuming that the ICE-86A command requires a 
hardware action). Thus, while the ICE-86A LOAD command merely specifies 
loading of a user program into user address space, the actual process requires 
reading of the memory map and writing of the user code into user, ICE, Intellec, or 
diskette memory as indicated by the map. Not only are multiple firmware com- 
mands required but the set of firmware commands issued is dependent on the 
parameters included within the ICE-86A command. 



REPEAT 

UNTIL IP = 1000H 

STEP 
ENDR 



;BREAK CONDITION 
;SINGLE STEP 



ICE-86A Architecture 
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ICE-86A Firmware 

ICE-86A firmware consists of a 12K-byte ROM-resident program that is executed by 
an 8080 "ICE processor" of the ICE-86A hardware. The firmware performs three 
major functions. During start-up or system reset, the firmware resets all hardware 
test parameters and performs a series of go/no-go tests to ensure proper operations 
of the ICE-86A hardware. In the interrogation mode, the firmware decodes the 
firmware commands and initiates the specified hardware operations including the 
sequencing of data transfers to and from the ICE-86A software. In the emulation 
mode, the firmware supports user program activities that require use of Intellec 
resources such as the transfer of user code from diskette or extended Intellec 
memory. 



ICE-86A Hardware 

ICE-86A hardware consists of five circuit boards and four cables. Three of the cir- 
cuit boards plug into the Intellec chassis: 

• FM Controller Board 

• 86 Controller Board 

• Trace Board 

Two smaller circuit boards are housed within the ICE-86A buffer box assembly: 

• Buffer Board 1 

• Buffer Board 2 

The buffer box cable assembly interconnects the user hardware and the ICE-86A cir- 
cuit boards within the Intellec chassis. Connection to the user system is made by this 
cable via the 40-pin socket that normally contains the 8086 user processor. When the 
ICE-86A emulator is thus connected to the user system, the functions of the user 
processor are assumed by an 8086 located within the buffer box assembly. The 8086 
in the buffer box assembly is called the user processor within this manual. The buf- 
fer box assembly is located near the user end of this cable assembly. 

'X' and 'Y' cables interconnect the buffer box and two circuit boards in the Intellec 
chassis. The T' cable provides direct connection between the 86 Controller Board 
and Trace Board. 

A block diagram of the ICE-86A hardware is shown in figure 1-2. 



Buffer Box Signals 

The buffer box has four external signal lines and a ground pin provided to help coor- 
dinate user's hardware with the ICE-86A emulator. 

These lines are: INITOUT/, EMUL, BRKEXT, and (MATCH0 OR MATCH1)/. 
Below is a brief user description of each line; signal characteristics are given in 
Appendix D. See Chapter 2 for installation of cables. 

The INITOUT/ line supports an output-only initialization signal that can reset user 
hardware working in conjunction with the 8086 CPU (such as the 8087 Numeric 
Data Processor or the 8089 Input/Output Processor). The signal is issued as part of 
the response to the RESET HARDWARE command (see Chapter 7); the pulse 
width is 550 microseconds and active low. 
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FM CONTROLLER BOARD 



TRACE BOARD 



Figure 1-2. ICE-86A™ Functional Block Diagram 
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The EMUL line carries an active high signal that indicates when the ICE-86A 
emulator is in emulation mode. The signal goes active 4 clock cycles before the first 
instruction fetch in emulation and terminates 7 clock cycles following the last 8086 
cycle emulated. 

The BRKEXT line allows an external signal to break emulation (such a signal may 
come from a coprocessor, a peripheral, etc.). The signal must change from high to 
low to break emulation; the break occurs on the instruction during which the break 
is initiated (i.e., the last instruction that is executed before leaving emulation mode). 
Emulation cannot be resumed through this line. 

NOTE 

In order for the BRKEXT facility to function, a jumper wire must be in 
place on the 86 Controller board, connecting J2 (the 'X' cable terminal), pin 
40, to RP1 (a resistor pack), pin 5. New ICE-86A products are shipped with 
this wire already installed. The user may be required to have this wire 
attached on upgrades to previously existing ICE-86 emulators. Before 
attempting to use the BRKEXT facility, the operator should examine the 86 
Controller board to determine if this jumper wire is in place. 

The (MATCHO or MATCH 1)/ line can provide a trigger signal whenever a break- 
point register condition is fulfilled. (See Chapter 6 for the setting of breakpoint 
registers.) The signal is active low and one clock cycle in duration. The user should 
be aware that a pulse from the (MATCHO or MATCH 1)/ line is not synonymous 
with a break in emulation; the ICE-86A emulator is capable of going out of emula- 
tion mode only when a breakpoint register condition is met and that register has 
been enabled by either the GO or GR commands. 
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NOTE 

When the system CLOCK is set to INTERNAL, the logic of the ICE-86A 
emulator causes the (MATCHO or MATCH 1)/ signal to be held high. In 
general, this means that when the emulator is not connected to user hard- 
ware, there is no external signal available to indicate when a breakpoint 
condition has been met. (See Chapter 6 for the CLOCK commands.) 

NOTE 

If the user connects an ICE-88A buffer box to an ICE-86A system, the 
following error will be generated: 

WARN C2:HARDWARE MISSING 

The ICE-86A system will not function in this configuration. 



Generalized Development Cycle with the 
ICE-86A Emulator 

Figure 1-3 diagrams a generalized product development cycle using the ICE-86A 
emulator as a design aid. The sequence of events in developing a new product using 
the Intellec system with the ICE-86A emulator is approximately as follows: 

• Complete the specifications for the prototype hardware design, software control 
logic, and integrated system performance. 

• Organize both the hardware and software designs into logical blocks that are 
readily understandable, have well-defined inputs and outputs, and are easy to 
test. Breaking down the design is an interactive process, but is extremely 
valuable in reducing the time required for prototyping, programming, testing, 
and modification. 

• Program the software modules in PL/M-86 and/or in ASM-86 assembly 
language, naming and storing the programmed modules as files under ISIS-Ik 
Compile or assemble the modules, linking and loading the combinations you are 
ready to test, creating an object-code (machine language) version. Desk-check 
each module as it is completed. 

• As software modules are ready for testing, load them into the ICE emulator, 
Intellec system, or diskette and emulate them via the ICE processor, using the 
ICE-86A emulator in the 'software' mode. The ICE-86A system allows you to 
use ICE-supplied memory as part of the 'prototype' system. The advantages of 
this feature to software development include: 

1 . You do not have to be concerned about overflowing your prototype system 
memory in the initial stages of software development. You have the 
freedom to test the program and compact it later without having to make 
room for extra memory in your prototype. 

2. You may test your program in RAM memory, and make patches quickly 
and easily without having to erase and reprogram PROM memory. In later 
test phases, the ICE module can control program execution from PROM or 
ROM in your prototype. The ICE module can map RAM memory to ICE- 
supplied memory to replace prototype memory in set increments, to test out 
software changes before reprogramming. 

• As software modules pass initial stages of check-out, they can be loaded in the 
2K of ICE-86A memory for emulation and testing in 'real-time'. 

• Hardware prototyping can begin with just a 8086 CPU socket. Through 
1CE-86A mapping capabilities, ICE-supplied equivalents can be substituted for 
missing prototype hardware. As each module of the user's hardware becomes 
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Figure 1-3. Typical Development Cycle with the ICE™ Module 
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available, it can be added to the prototype, replacing the ICE-supplied 
equivalent. In this way, modules of software and hardware can be system tested 
as they become available. 

• You can use memory in ICE-supplied system to check the interaction of 
prototype hardware and proven software. The ability to map memory is helpful 
in isolating system problems. You can exercise all prototype memory from a 
program residing initially in ICE-supplied memory, and reassign memory block- 
by-block to the user's system as code is verified. Hardware failures can then be 
isolated quickly, because interactions between prototype parts occur only at 
your command. You do not have to use the prototype to debug itself. 

• The debugging/testing process can proceed through each hardware and 
software module, using ICE-86A commands to control execution and check 
that each module gets data or control information from the correct locations, 
and places correct data or other signals in the proper cells or output locations 
for subsequent modules to use. 

• Eventually, you test all hardware and software together. The program can 
reside in RAM or PROM in your system, or in RAM in the Intellec system. All 
other hardware can be in the prototype. The ICE-86A emulator, connected to 
the system through the microprocessor socket, can emulate, test, and trace all 
the operations of the system. 

• After the prototype has been completely tested, the ICE-86A emulator can be 
used to verify the product in production test. The test procedures you developed 
for the final prototype testing can serve as the basis for production test routines, 
running the program from metal-masked ROM in the production system. 



A Generalized Emulation Session 

This section describes the main steps in an emulation session. You may not always 
perform all the procedures given here in every emulation session, but the main 
outline is the same in all sessions. The discussion emphasizes some of the features of 
the ICE-86 A emulator that have not been presented earlier. For the details of the 
command language, see Chapters 4 through 8. 

1 . Install the ICE-86A hardware in the Intellec chassis (see Chapter 2). 

2. If you are using any prototype hardware, remove socket protector and attach 
the cable that connects the user hardware to the ICE-86A circuit boards to the 
prototype via the 40-pin socket. Otherwise leave socket protector attached to the 
cable. 
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3. Boot the system, and obtain the hyphen prompt from the ISIS-II system. Enter 
the ICE86 command, and obtain the asterisk prompt from the ICE-86A 
emulator. 

4. From the software to be tested, determine how many memory addresses in the 
Intellec system are required to perform the current emulation. For example, if 
your program presently uses 3K of memory but your prototype has only IK 
installed, you need to "borrow" 2K of memory from the ICE-86A emulator. 

ICE-86A system memory is available from three sources: 2K of "real-time" 
ICE memory, extended Intellec RAM memory, and diskette memory. This 
memory is available for user program mapping and is organized in blocks of IK 
(1024) bytes of contiguous memory. 1024 such blocks are logically available; the 
amount that is physically available depends upon what you have installed in the 
Intellec. 

The ICE memory provides you with 2K of RAM memory that enables you to 
run object code at approximately real-time speed. 

Intellec memory is capable of providing 960 IK blocks of logical address space. 
The Intellec system software occupies the lowest 64K of Intellec RAM memory. 
Therefore, any Intellec memory available to the user programs must be mapped 
to addresses above 64K (extended Intellec memory). The amount of Intellec 
memory physically available is dependent upon the number of card slots 
available in the Intellec system and the memory physically installed. (Do not use 
016 memory boards). If diskette memory is used, the full range of 1024 blocks 
of logical memory is available to the user program up to the size of the diskette. 

Typically, your program occupies logical locations in low memory. If you 
intend to use Intellec memory for this emulation, you must map the memory 
space used by your program into extended Intellec memory. The ICE-86A 
emulator stores the mapping in its memory map, and refers each memory 
reference in your program to the proper physical location in Intellec memory. 
For example, suppose your code requires absolute addresses 0000H to 0FFFH 
(the "H" means hexadecimal radix), or 4096 contiguous locations beginning at 
location 0, the lowest address in memory. To map these addresses into the 
beginning of extended Intellec memory, the mapping command would be: 

MAP INTELLEC = 64 LENGTH 62 

This command declares that 62K of RAM memory is physically available in 
extended Intellec memory starting at the lower boundary of extended memory. 

MAP 0 LENGTH 4 = INTELLEC 

This command maps the logical memory required by your program to address 
the address space in lower Intellec extended memory. 

5. Load your program from diskette into the memory locations you have mapped, 
using the LOAD command. 

6. The ICE-86A emulator has three modes of operation: interrogation, continuous 
emulation, and single-step emulation. The asterisk prompt signals that the 
ICE-86 A emulator is in the interrogation mode, ready to accept any command. 

7. In the interrogation mode, prepare the system for emulation by defining 
symbols and setting emulation breakpoints and tracepoints. 

ICE-86A software provides keywords for all 8086 registers and flags. In addi- 
tion, you may use symbols to refer to memory locations and contents. The user 
symbol table is generated along with the object file during PL/M compilation or 
ASM assembly. This table can be loaded into Intellec memory when the user 
program is loaded. 

You are encouraged to add to this symbol table any additional symbolic values 
for memory addresses, constants, or variables that you may find useful during 
system debugging. Symbols may be substituted for numeric values in any of the 
ICE-86A commands. 
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Symbolic reference is a great advantage to the designer. You do not need to 
recall or look up the addresses of key locations in your program, as they change 
with each assembly; you can use meaningful symbols from your source program 
instead. This facility is especially valuable for high-level language debugging. 
You can completely debug a program written in PL/M by referencing symbols 
defined in the source code. You do not need to become involved with the 
machine level code generated by the compiler. For example, the ICE-86A 
command: 

GO FROM .START TILL .RSLT WRITTEN 

begins real-time emulation of the program at the address referenced by the label 
START in the designer's PL/M-86 program. The command also specifies that 
the program is to break emulation when the 8086 microprocessor writes to the 
memory location referenced by RSLT. You do not have to be concerned with 
the physical locations of START and RSLT. The ICE-86A software supplies 
them automatically from information stored in the symbol table. 

8. Enter a GO command to begin real-time emulation. The ICE-86A emulator uses 
a pseudo-register called the GO-register to contain the halting conditions that 
you have specified, either in the GO command or previously. 

9. When emulation halts, you display the trace data collected during that 
emulation. The ICE-86A emulator loads trace data into a trace buffer. Using 
ICE-86A commands, you can position the trace buffer pointer to the informa- 
tion that you desire to review, and display one, several, or all the entries in the 
buffer. You can set the display mode to one frame per line or one instruction per 
line of display. 

10. To control emulation more precisely and to obtain more detailed trace data than 
with continuous emulation, you can command the ICE-86A emulator to execute 
single-step emulation. After each step emulated, you can display the current 
entry in the trace buffer and the current settings of the 8086 registers and pins. 

11. You can examine and change memory locations, 8086 registers and flags, and 
I/O ports, to provide you with valuable information on program operation. 
You may alter data or register values to observe their effect on the next emula- 
tion, or you can patch in changes to your program code itself. You can display 
and change symbolic values in the symbol table and breakpoint and tracepoint 
values. 

12. Alternate between interrogation and emulation until you have checked 
everything you want to check. 

13. At the end of the emulation session, you can save your debugged code on an 
ISIS-II diskette file, using the ICE-86A SAVE command. The operation can be 
specified to save program code, symbol tables, and (for PL/M programs) the 
source code line number table. 

You can start another session immediately, resetting all parameters to their 
initial values with a few simple commands, or you can exit to ISIS-II to ter- 
minate the session. 

This introduction is intended to show you some of the scope and power of the 
ICE-86A emulator in operation, and to suggest how this integrated software/ 
hardware design aid can fit into your development cycle. Chapter 2 contains installa- 
tion instructions. Chapter 3 contains a hands-on tutorial involving a sample pro- 
gram to be debugged. Chapter 4 describes the meta-notation used in this manual to 
specify command syntax and semantics. Chapter 5 presents a detailed description of 
expressions used in this manual. The remaining chapters present the details of the 
command language in a format and sequence designed for reference. 
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_ — CHAPTER 2 
ICE-86A™ INSTALLATION 
PROCEDURES 



This chapter provides step-by-step instructions for installing ICE-86A hardware in 
an lntellec Microcomputer Development System. 



ICE-86A Components 

The following items are included in the ICE-86A package. 

• FM Controller board: A circuit board that plugs into the lntellec chassis. The 
FM Controller contains the 8080 ICE processor, 12K-byte firmware ROM, and 
3K-bytes of scratchpad RAM 

• 86 Controller board: A circuit board that plugs into the lntellec chassis. The 86 
Controller contains the 2K-bytes of ICE RAM, the IK by 6-bit MAP memory, 
and 512 bytes of 2-Port memory. 

• ICE-86A Trace board: A circuit board that plugs into the lntellec chassis. The 
ICE-86A Trace board contains RAM for trace data, tracepoints, and 
breakpoints. 

• ICE-86A Buffer Box Assembly: A cable assembly that contains the ICE-86A 
Buffer Box Assembly. The Buffer Box contains two small circuit boards that 
contain the 8086 user processor and gating and control logic for communica- 
tions with the user system, MAP RAM, ICE RAM, 2-Port RAM, and Trace 
RAM. The cable assembly also contains the user cable that plugs into the 40-pin 
socket that normally houses the user's 8086, the "X" cable that attaches to the 
86 Controller board, and the "Y" cable that attaches to the FM Controller 
board. 

• lntellec Model 800 Triple Auxiliary Connector and lntellec Series II Triple 
Auxiliary Connector: Each connector consists of a set of three parallel circuit 
board connectors that provide electrical interconnection between the FM 
Controller, ICE-86A Trace board and the 86 Controller when they are installed" 
in the lntellec chassis. 

• The "T" cable that connects the Trace board to the 86 Controller board. 

• Ground Cable: A cable that provides signal ground to the ICE-86A Buffer Box 
Assembly from the user system. 

• Software files on the ICE-86A diskette: 



ICE86 
ICE86, 
ICE86. 
ICE86. 
ICE86. 
ICE86. 
ICE86. 
ICE86. 



OV0 
OV1 
OV2 
OV3 
OV4 
OV5 
OV6 



ICE86.0V7 
ICE86.OV8 
ICE86.0V9 
ICE86.OVA 
ICE86.OVE 
8087. MAC 
8087. HLP 
ERROR. MAC 



RBF89 

RBF89.OV0 

RBF89.0V1 

RBF89.0V2 

RBF89.0V3 

RBF89.0V4 

RBF89.0V5 

RBF89.0V6 



RBF89.0V7 
RBF89.0V8 
RBF89.0VB 
RBF89.0VC 
RBF89.0VD 
RBF89.0VE 



These files provide the software to support design of systems using the 8086, the 
8087, and the 8089 chips. 

Required and Optional Hardware 

The ICE-86A emulator requires one of the following hardware configurations: 
• lntellec model 800 with: 
CRT 
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Microcomputer Development System 2DS or DDS 
64K of RAM 

3 adjacent card slots available on the motherboard 

• Intellec model 888 with 64K of RAM and 3 adjacent card slots available on the 
motherboard. 

• Intellec Series II, model 220, 225, or 230, or Intellec Series III model 286 with: 

3 adjacent card slots available in the expansion chassis and 64K of RAM 

The following are optional enhancements to an ICE-86A system: 

• Teletypewriter or line printer for hard-copy output 

• One or more boards of Intellec expansion memory. If Intellec expansion 
memory is to be used for emulating 8086 program memory, additional card slots 
are needed for iSBC 032 or iSBC 064 memory boards. If Intellec expansion 
memory is used, it is recommended that all Intellec memory consist of iSBC 032 
and/or iSBC 064 memory boards. iSBC 016 memory boards decode only 16 bits 
of address. Therefore, if any iSBC 016 boards are present when expansion 
memory is being used, each 16K RAM board will be duplicated on each 64K 
page of addressable memory making these duplicated areas unusable for pro- 
gram storage. 

NOTE 

The Monitor in the Intellec model 800 and 888 occupies the upper 
2K of the first 64K of Intellec memory. This address space will be 
duplicated on each 64K page of Intellec expansion memory used 
and therefore unusable for user program storage. 

Hardware Installation Procedures 

Installation procedures are presented in the next two sections as follows: the pro- 
cedure for Intellec model 800 and 888; the procedure for Intellec Series II model 220, 
225, 230, and the Intellec Series III model 286. 



Installation Procedures for Intellec Model 800 and 888 

1. Inspect the ICE-86A assemblies for damage. 

2. Disconnect power cords from the Intellec chassis and the user system. 

3. Remove the top cover from the Intellec chassis. 

4. Ensure that shorting plug PI on the FM Controller board connects jumper posts 
El -2, setting the ICE-86A device code to 0. Ensure that shorting plug P2 on the 
FM Controller board connects jumper posts E7-E8, selecting the Multibus inter- 
face -10V power source as the board's -5V supply. 

5. Insert the P2 edge connector of the ICE-86A Trace board into the middle slot of 
the Intellec model 800 Triple Auxiliary connector. 

6. Install the Trace board (with Triple Auxiliary Connector attached) into an even 
numbered slot in the Intellec cardoage so that there is an empty card slot on each 
side of the Trace board. > 

7. Install the FM Controller board next to the Trace board in the odd slot with the 
number lower than the Trace board. For example, when the Trace board is in 
slot 10, the FM Controller board is placed in slot 9. 

8. Install the 86 Controller board next to the Trace board in the slot with the 
number higher than the Trace board. Figure 2-1 shows the proper order of the 
boards in the cardcage. 
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Figure 2-1 . Orientation of Circuit Boards 



162554-18 



NOTE 

The Triple Auxiliary Connector can be bolted to the motherboard 
if permanent installation of the 1CE-86A Module is desired. The 
bottom cover of the Intellec chassis must be removed to gain access 
to the mounting holes (mounting hardware is supplied with the 
connector). 

9. Attach the 'T' cable to the 4 T' connectors on the Trace board and the FM 
Controller board, ensuring that the missing pin on the connectors mates prop- 
erly to the blocked hole in the cable receptacles. 

10. Attach the ribbon cable marked 'X' from the Buffer Box Assembly to the 'X' 
connector on the 86 Controller board, ensuring that the missing pin on the con- 
nector mates properly to the blocked hole in the cable receptacle. 

11. Attach the ribbon cable marked 'Y' from the Buffer Box Assembly to the 'Y' 
connector on the FM Controller board, ensuring that the missing pin on the 
connector mates properly to the blocked hole in the cable receptacle. 

12. Install expansion RAM in the Intellec chassis as required for user software. 

13. If a user prototype is to be connected, remove the Socket Protector Assembly 
from the user end of the ICE-86A Buffer Box Assembly and insert the 40-pin 
cable terminal into the 8086 socket on the user system. The Socket Protector 
Assembly guards the terminal pins from damage and inadvertent grounding. 



Ensure that pin 1 of the terminal connector is aligned to pin 1 of the 
40-pin user system CPU socket. Damage to ICE components may 
result when the connector is improperly installed. 
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14. Mount the male plug of the Ground Connector into the female receptacle of the 
Terminal Pin at the user end of the cable assembly. 

15. Mount the clip end of the Ground Connector to an appropriate point in the user 
system to provide signal ground. 



Failure to observe proper grounding techniques between the ter- 
minal connector ground lead and the user system may result in 
ICE-86A failures. 

16. Route the 'X' and 'Y' cables out the back of the chassis, over the top lip on the 
rear panel. 

17. Replace the top cover on the Intellec chassis. The cover fits snugly over the two 
ICE cables at the back of the chassis. 

18. Connect the power cords to the Intellec chassis and the user system. 

Installation Procedures for Intellec Series II Model 220, 225, 
and 230, and Intellec Series III Model 286 

1 . Inspect the ICE-86A assemblies for damage. 

2. Disconnect power cords from the Intellec chassis, the expansion chassis, and the 
user system. 

3. Remove the front panel from the expansion chassis. 

4. Ensure that shorting plug PI on the FM Controller board connects jumper posts 
El -2, setting the ICE-86A device code to 0. Ensure that shorting plug P2 on the 
FM Controller board connects jumper posts E8-E9, selecting the Multibus inter- 
face -12V power source as the boards -5V supply. 

5. Insert the P2 edge connector of the ICE-86A Trace board into the middle slot of 
the Intellec Series II Triple Auxiliary Connector. 

6. Install the Trace board (with Triple Auxiliary Connector attached) into the 
expansion chassis so that there is an empty card slot on each side of the Trace 
board. 

7. Install the FM Controller board in the expansion chassis slot immediately above 
the Trace board. 

8. Install the 86 Controller board in the expansion chassis slot immediately below 
the Trace board. Figure 2-1 shows the proper order of the boards in the expan- 
sion chassis. 



NOTE 

The Triple Auxiliary Connector can be bolted to the expansion 
backplane if permanent installation of the ICE-86A Module is 
desired. The top cover of the expansion chassis must be removed to 
gain access to the mounting holes (mounting hardware is supplied 
with the connector). 



9. Attach the 'T' cable to the T' connectors on the Trace board and the FM 
Controller board, ensuring that the missing pin in the connectors mates properly 
to the blocked hole in the cable receptacles. 

10. Attach the ribbon cable marked 'X' from the Buffer Box Assembly to the 'X' 
connector on the 86 Controller board, ensuring that the missing pin on the con- 
nector mates properly to the blocked hole in the cable receptacle. 
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11. Attach the ribbon cable marked 'Y' from the Buffer Box Assembly to the *Y' 
Connector on the FM Controller board, ensuring that the missing pin on the 
connector mates properly to the blocked hole in the cable receptacle. 

12. Install expansion RAM in the Intellec mainframe or expansion chassis as 
required for user software. 

13. If a user prototype is to be connected, remove the Socket Protector Assembly 
from the user end of the 1CE-86A Buffer Box Assembly and insert the 40-pin 
cable terminal into the 8086 socket on the user system. The Socket Protector 
Assembly guards the terminal pins from damage and inadvertent grounding. 



Ensure that pin 1 of the terminal connector is aligned to pin 1 of the 
40-pin user system CPU socket. Damage to ICE components may 
result when the connector is improperly installed. 

14. Mount the male plug of the Ground Connector into the female receptacle of the 
Terminal Pin at the user end of the cable assembly. 

15. Mount the clip end of the Ground Connector to an appropriate point in the user 
system to provide signal ground. 



Failure to observe proper grounding techniques between the ter- 
minal connector ground lead and the user system may result in 
ICE-86A failures. 

16. Replace the front cover of the expansion chassis, routing the ribbon cable out 
the opening at the left side of the front panel. 

17. Connect the power cords to the Intellec mainframe and expansion chassis and 
user system. 



NOTE 

Keep the Socket Protector Assembly mounted on the end of the 
ICE Buffer Box Assembly terminal cable whenever the terminal is 
not attached to a user system to prevent pin damage. 

When removing the Socket Protector Assembly from the end of the 
ICE Buffer Box Assembly, use care to prevent pin damage. 



Accessing External Buffer Box Signals 
and Ground Pin 

As detailed in Chapter 1, the ICE-86A buffer box has four external signal lines— 
INITOUT/, (MATCHO OR MATCH1), EXTBRK, and EMUL— as well as a 
ground pin, to aid in coordinating user's hardware with the ICE-86A emulator. One 
horizontal side of the buffer box has been left exposed to provide easy access to 
these signal lines and the ground pin; the user may make connections to external 
hardware with any appropriate-sized electrical clips. For operator's convenience, the 
lines and ground have been labeled 1 through 5 on the buffer box — 1 for 
INITOUT/, 2 for (MATCHO OR MATCH1)/, 3 for GND, 4 for EXTBRK, and 5 
for EMUL. 
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Confidence Testing 

The DIAG86 Confidence Test program verifies operation of the ICE-86A Module 
after installation or whenever problems with the ICE Module itself are suspected. 
The DIAG86 program resets and invokes the ICE-86A emulator, executes a set of 
hardware confidence tests, and terminates by returning a "PASS" or "FAIL" 
display message. Execute the following sequence to run the confidence tests: 

• Boot the system to run under ISIS-II and wait for the hyphen prompt (-) from 
the ISIS-II system. 

• Enter the command CONF and wait for the asterisk prompt (*). 

• Enter the command INIT DIAG86.CON and wait for the asterisk prompt (*). 

• Enter the command TEST to cause DIAG86 to execute the confidence tests. 
Wait for the test message displays. DIAG86 will display a "PASS/FAIL" 
message for each diagnostic test contained in DIAG86. If any displayed test 
message denotes a "FAIL", the installed hardware is not operating properly. 
Inspect the hardware for improper installation and rerun DIAG86. If all the 
displayed test messages denote "PASS", the hardware has been installed cor- 
rectly and is operating properly. 

• Enter the command EXIT to return control to the ISIS-II system. 
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CHAPTER 3 
SAMPLE ICE-86A™ SESSIONS 
AT THE TERMINAL 



This chapter introduces a few useful ICE-86A commands and provides hands-on 
experience with the ICE-86A emulator. To reduce the need for cross-reference, this 
chapter includes brief discussions of the commands used in the examples. The user 
program to be simulated is a simple traffic light controller. The user program logic is 
described before the hands-on session to help you understand what is going on. 



• To use this program as a hands-on tutorial, you must enter the source code for 
the two modules using the ISIS text editor on your system. Omit the line number 
and nesting information that is on the listing; these values are assigned by the 
compiler and assembler. 

• Compile the CARS module with the PL/M-86 compiler program. Assuming 
that the source file is named "CARS. SRC", the compile step could look like: 

-PLM86 :F1 :CARS.SRC PRINT(:F1 :CARS.PRT) DEBUG 

The object file created by PLM86 is named CARS. OB J. (The DEBUG control 
generates the symbol table for use by ICE-86A.) 

• Assemble the DELAY module with the ASM86 assembler. Assuming that the 
source file is named "DELAY. SRC", the assemble step could look like: 

-ASM86 :F1:DELAY.SRC PRINT(:F1 .DELAY. PRT) OBJECT(:F1 :DELAY.OBJ) DEBUG 

As indicated, the object module is named DELAY.OBJ. 

• Link and Locate CARS and DELAY using the iAPX-86 utilities LINK86 and 
LOC86. The command we used looks like: 

-LINK86 :F1:CARS.OBJ, :F1:DELAY.OBJ TO :F1:CARS.LNK 

The LINK86 command displays two warning messages when modules in 
DELAY.OBJ are combined. The output CARS.LNK must be located 
absolutely in memory using the LOC86 Command. 

-LOC86:F1 .CARS.LNK 

The file created by LOC86 is named CARS. This file will be the input used 
during the ICE86A session. 

• For further information on the procedures for editing, compiling, assembling, 
linking, and locating programs under iAPX-86, refer to the following manuals: 

Text Editor: 75/5-/7 System User's Guide 

PL/M-86 Compiler: PL/M-86 User's Guide 

ASM-86 Assembler 8086/8087/8088 Macro Assembly Language Reference 



LINK86 and LOC86 8086 Family Utilities User's Guide 

• Study the logic of CARS, the program to be emulated. The material includes 
text discussion and program listings. 

• Install the ICE-86A hardware following the procedure given in Chapter 2. 
Leave the socket protector on to protect the pins at the end of the cable. 

• Insert an ISIS-II system diskette in drive 0, boot ISIS. 

• Copy CARS to the diskette containing the ICE-86A program. Insert this 
diskette in drive 1 . 



How To Use This Chapter 



Manual 



8086/8087/8088 Macro Assembler Operating 
Instructions 



3-1 



Sample ICE-86A Sessions at the Terminal 



ICE-86A 



• Enter the command 

:F1:ICE86 

to load the ICE software and start it executing. The ICE-86A emulator signals 
readiness to accept commands by displaying an asterisk prompt (*). 

• Enter the ICE-86A commands as shown, and obtain the results shown in the 
listing. 

Analysis of the Sample Program 

The application presented is a simple traffic light controller. Imagine an intersection 
of a main street and a side street. The desired operation is that the light should stay 
green on the main street until a decision involving the number of cars waiting on the 
side street and the amount of time they have been waiting has been satisfied. We 
suppose that there is a sensor in the pavement on the side street that sends an inter- 
rupt to the computer when a car arrives. We do not include the control of a yellow 
light on either street. 

Refer to the following figures: 

Figure 3-1 . CARS Module Listing 
Figure 3-2. Delay Module Listing 

Associated with each street is a time called the cycle length. In the program, the 
variable named SIDE$CYCLE$LENGTH controls the fixed length of time the light 
is green on the side street when that cycle is called into action. Even though the light 
stays green on the main street until the decision rule is satisfied, we need a variable 
MAIN$CYCLE$LENGTH that is involved in the decision rule. 

The decision rule is as follows. The side street gets a green light if either of the 
following two conditions is satisfied. 

1. Two or more cars are waiting on the side street, and the main street has had 
the green light for a period of time greater than or equal to the variable 
MAIN$CYCLE$LENGTH. 

2. One car is waiting on the side street, and the main street has had the green 
light for a period of time equal to or greater than two times the variable 
MAIN$CYCLE$LENGTH. 

The system has one input and one output. The input is a signal that a car has arrived 
on the side street since the last time we sampled the input. The variable 
CARS$ WAITING contains the number of cars waiting on the side street. The out- 
put goes to the traffic light controller. We assume that sending the controller a 1 
makes the light on the main street green and the light on the side street red; sending it 
a 0 makes the light on the main street red and the light on the side street green. The 
variable LIGHTSSTATUS represents this output. 

The program is initialized with constants and variables set as follows. 

MAIN$CYCLE$LENGTH = 8 seconds 
SIDE$CYCLE$LENGTH = 5 seconds 

MAIN$TIME = 0 (Time since last change to MAIN GREEN, SIDE RED) 
SIDE$TIME = not set yet. (Time since last change to SIDE GREEN) 
LIGHTSSTATUS = 1 (MAIN GREEN, SIDE RED) 
GARS$WAITING = 0 

The CARS program contains a procedure CYCLE to change the lights back and 
forth. CYCLE holds the side street light green (main red) until its counter, 
SIDET1ME, exceeds the SIDECYCLELENGTH (nominally 5 seconds). 
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r TRAFFIC LIGHT CONTROLLER PROGRAM * / 

1 CARS: 
DO; 

2 1 DECLARE (M AIMTIME, SIDE$TIME) BYTE; 

3 1 DECLARE MAIN$CYCLE$LENGTH BYTE DATA(8), SIDE$CYCLE$LENGTH BYTE DATA(5); 

4 1 DECLARE CARS$WAITING BYTE; 

5 1 DECLARE LIGHT$STATUS BYTE; 

6 1 DECLARE FOREVER LITERALLY 'WHILE V; 

7 1 SIDE$STREET$CAR: 

PROCEDURE; 

8 2 CARS$WAITING = CARS$WAITING + 1; 

9 2 END SIDE$STREET$CAR; 

/* FOLLOWING PROCEDURE CODED IN ASSEMBLY LANGUAGE AND LINKED IN */ 

10 1 DELAY: 

PROCEDURE(TIME$HUNDREDTHS) EXTERNAL; 

11 2 DECLARE TIME$HUNDREDTHS BYTE; 

12 2 END DELAY; 

13 1 DISPLAY: 

PROCEDURE (CYCLE$TIME); 

14 2 DECLARE CYCLE$TIME BYTE; 

15 2 LIGHT$STATUS = LIGHT$STATUS; 

16 2 END DISPLAY; 

17 2 CYCLE: 

PROCEDURE; 

18 2 LIGHT$STATUS = 0; /* MAIN RED, SIDE GREEN */ 

19 2 SIDE$TIME = 0; 

20 2 DO WHILE SIDE$TIME <= SIDE$CYCLE$LENGTH; 

21 3 CALL DISPLAY(SIDE$TIME); 

22 3 CALLDELAY(100); 

23 3 SIDE$TIME = SIDE$TIME + 1; 

24 3 END; 

25 2 LIGHT$STATUS = 1; /* MAIN GREEN, SIDE RED * / 

26 2 END CYCLE; 

/• MAIN PROGRAM - EXECUTION BEGINS HERE */ 

27 1 LIGHT$STATUS = 1; /* START WITH MAIN GREEN */ 

28 1 CARS$WAITING = 0; 

29 1 MAIN$TIME = 0; 

30 1 DO FOREVER; 

31 2 CALL DISPLAY(MAIN$TIME); 

32 2 CALLDELAY(100); 

33 2 MAIN$TIME = MAIN$tlME + 1 ; 

34 2 IF (CARS$WAITING >= 2) AND (MAIN$TIME >= MAIN$CYCLE$LENGTH) 

OR (CARS$WAITING = 1) AND (MAIN$TIME >= 2 * MAIN$CYCLE$LENGTH) THEN 

35 2 DO; 

36 3 CALL CYCLE; 

37 3 CARS$WAITING = 0; 

38 3 MAIN$TIME-0; 

39 3 END; 

40 2 END; 

41 1 END CARS; 



Figure 3-1. CARS Module Listing 
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1 OP 


OR 1 




LINE 


SOURCE 












1 


CGROUP 


GROUP 


ABS__0, CODE, CONST, DATA, STACK, MEMORY 








2 


DGROUP 


GROUP 


A BS_0 , CODE , CO N ST , DATA , STACK , M E MOR Y 








3 




ASSUME 


DS:DGROUP,CS:CGROUP,SS:DGROUP 








4 


CONST 


SEGMENT 


WORD PUBLIC 'CONST' 








5 


CONST 


ENDS 










6 


DATA 


SEGMENT 


WORD PUBLIC 'DATA' 








7 


DATA 


ENDS 










8 


STACK 


SEGMENT 


WORD STACK 'STACK' 


0000 






g 


STACK BASE 


LABEL BYTE 








10 


STACK 


ENDS 










11 


MEMORY 


SEGMENT 


WORD MEMORY 'MEMORY' 








19 
I c 


MEMORY, 


_LABEL 


LABEL BYTE 








13 


MEMORY 


ENDS 










14 


ABS_0 


SEGMENT 


BYTE AT0 


0000 






15 


M 


LABEL 


BYTE 








16 






; TIME DELAY SUBROUTINE 








17 
18 


ABS_0 


ENDS 










19 


CODE 


SEGMENT 


WORD PUBLIC 'CODE' 








20 




PUBLIC 


DELAY 


0000 


5B 




21 


DELAY: POP BX ;POP RETURN ADDR. OFF STACK 


0000 


59 




22 




POP CX ;POP ARGUMENT OFF STACK INTO CX REG. 


0002 


53 




23 




PUSH BX 


;REPLACE RETURN ADDR. ON STACK 


0003 


8AC1 




24 




MOV 


AL,CL ; PL/M LINKAGE CONVENTION 


0005 


B5FF 




25 




MOV 


CH,255 


0007 


8ACD 




26 


LAB1: 


MOV 


CL.CH 


0009 


FEC9 




27 


LAB2: 


DEC 


CL 


000B 


891E2300 


R 


28 




MOV 


TEMP.BX ; WASTE 


000F 


891E2300 


R 


29 




MOV 


TEMP,BX ; DITTO 


0013 


891E2300 


R 


30 




MOV 


TEMP.BX ; 


0017 


891E2300 


R 


31 




MOV 


TEMP.BX 


001 B 


90 




32 




NOP 




001 C 


75EB 




33 




JNZ 


LAB2 


001 E 


FEC8 




34 




DEC 


AL 


0020 


75E5 




35 




JNZ 


LAB1 


0022 


C3 




36 




RET 










37 








0023 






38 


TEMP 


LABEL 


WORD 


0023 


02 




39 




DB 


2 








40 


CODE 


ENDS 










41 




END 





Figure 3-2. DELAY Module Listing 
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The ICE-86A test suite includes commands that simulate the arrival of cars on the 
side street, and that display the values of the program variables involved in the light 
change logic. The procedure SIDESTREETCAR represents the nucleus of the inter- 
rupt routine that would handle the sensor interrupts in a real traffic light controller 
program. The interrupt-enabling logic is omitted for simplicity. Procedure 
DISPLAY is a 'vestige' of a previous version of CARS. CARS also calls DELAY 
when a 'one-second' timer is required. 

ICE-86A Emulator Hands-On Demonstration 

This demonstration involves the one program CARS. The version we ran did not 
have any serious logic errors, so that the effects of the ICE-86A commands could be 
clearly seen. The length of the delay produced by the DELAY routine is longer than 
desired; you may adjust the calling parameter if you desire a "true" one-second 
delay. 

The material represents two separate sessions at the terminal. The beginning and end 
of each session is clearly indicated. By using two sessions we can demonstrate the use 
of the PUT and INCLUDE commands. 

The pair of sessions is organized as follows — session 1 shows how to define and save 
macros on file; the macros defined in this session are of two kinds: general purpose 
MCS-86 utilities (PUSH86, POP86, SETIP) and macros that are particular to 
CARS, the demonstration program. 

The demonstration emphasizes the ICE-86A macro facility, showing how four basic 
ICE operations (initialize, emulate, display, change) can be organized into named 
blocks — the building blocks of test sequences. 

The define macro command has the syntax: 

DEFINE MACRO macro-name cr 

[command cr]... 

EM 

The commands inside a macro definition (including calls to other macros) are 
not examined or executed by the ICE-86A emulator until the macro is invoked. A 
macro call has the format: .macro-name. More details on commands are given in the 
following discussion. 
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Session 1 

0 We begin the session by entering :F1:ICE86 to ISIS-II (hyphen prompt), and 
receive the ICE-86A sign-on message and asterisk prompt. To record the 
ICE- 86A session on diskette file, we enter a LIST command with the drive and 
filename that is to contain the output of the ICE-86A operations (including 
error messages if any). 

Many of the commands include comments. A comment is preceded by a 
semicolon (;) to separate it from the command. 

The discussion is keyed to the listing by margin numbers. 

1 Macro PUSH86 simulates the iAPX-86 PUSH instruction. SP is the stack 
pointer; SS is the base address of the stack segment. 

POP86 is the reverse procedure, simulating the iAPX-86 POP instruction. 

The parameter %0 in both PUSH86 and POP86 lets us "push" or "pop" any 
register (or expression, etc.) as long as it can be expressed as a WORD-type 
quantity. 

2 Macro SETIP resets the instruction pointer CS:IP to the address (symbol, 
expression, etc.) passed as a parameter when the macro is invoked. CS is the 
base of the code segment and IP is the instruction pointer relative to CS. Like 
PUSH86 and POP86, SETIP is a useful macro for restarting emulation at a 
desired point (without 'softwiring' start addresses into your emulation macros). 

3 Macro TYPES demonstrates how to set up to use typed memory references. A 
symbol that stands for the address of a variable (not a procedure name) can be 
defined or assigned a memory-type. Examples of memory-types are BYTE, 
WORD, and POINTER. In our CARS program, all the key variables are of 
type BYTE. Since the symbols are loaded with the program rather than being 
DEFINED, we assign types to the variable with the commands of the form: 

TYPE .symbol-name = memory-type 

Then, as shown later on (e.g., in macro VARIABLES, step 6 of session 1) we 
can refer to the contents of any typed variable with a typed memory reference of 
the form 

\symbol-name 

The contents produced by a typed memory reference are automatically of the 
type assigned or declared. 

See Chapter 7 for more details on memory types. 
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-:F1:ICE86 

ISIS-ll ICE-86/86A, V2.0 

♦LIST :F1:DEC10.LOG ;SESSION ONE 

♦DEFINE MACRO PUSH86 

•*SP = SP - 2T ;MOVE POINTER TO NEW TOP OF STACK 

•'WORD SS:SP = %0, ;PUSH PARAMETER ON STACK 

•*EM ;END OF MACRO PUSH86 



♦DEFINE MACRO POP86 
•*%0 = WORDSS:SP 
•*SP = SP + 2T 
•♦EM 



POP PARAMETER OFF STACK 

MOVE POINTER TO NEW TOP OF STACK 

END OF MACRO POP86 



♦DEFINE MACRO SETIP 
•♦CS = SEG (%0) 
•*IP = OFF(%0) 

•*EM ;END OF MACRO SETIP 
♦DEFINE MACRO TYPES 

•♦TYPE .MAINTIME = BYTE ;FROM PLM LISTING 
•♦TYPE .SIDETIME = BYTE ;FROM PLM LISTING 
•♦TYPE .MAINCYCLELENGTH = BYTE ;FROM PLM LISTING 
•♦TYPE .SIDECYCLELENGTH = BYTE ;FROM PLM LISTING 
•♦TYPE .CARSWAITING = BYTE ;FROM PLM LISTING 
•♦TYPE .LIGHTSTATUS = BYTE ;FROM PLM LISTING 
•♦EM ;END OF MACRO TYPES 
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4 We define a macro IN IT to handle the map and load steps for our program, 
CARS. 

In the macro INIT, the command MAP 0 LENGTH 2 = ICE 0 assigns two 
memory blocks (IK segments) to ICE memory. The CARS program was 
LOCATed at ORIGIN 0 (LOC86 step discussed above) to facilitate mapping to 
ICE memory. 

INIT defines a useful symbol, .START = CS:IP. After LOAD, CS:IP points to 
the first executable instruction in the user program. CS is the base of the code 
segment and IP is the instruction pointer (relative to CS). 

Then, INIT calls the TYPES macro defined in step 3. This macro will become 
part of INIT whenever INIT is called. Until INIT is called, however, the call to 
TYPES is not executed. 

Finally, INIT displays the symbol and statement number tables, to verify that 
the LOAD step has been completed, and that the TYPES macro has executed. 

5 Macro EXAM is designed to test the logic that controls the light change. 
Basically, the macro block is an indefinite REPEAT loop (the block beginning 
with REPEAT and ending with ENDREPEAT). On each iteration a single step 
is emulated (one instruction). Following that, we use an IF command to look for 
certain addresses and take appropriate actions. The action taken in all cases is to 
display the PL/M statement or an equivalent message using the WRITE com- 
mand (see step 6 for more on the WRITE command). In addition, we skip both 
DELAY and DISPLAY by popping the return address and call parameter off 
the stack. 
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DEFINE MACRO INIT 

*MAP 0 LENGTH 2 = ICE 0 ;MEMORY SPACE FOR CARS PROGRAM 

*MAP 0 LENGTH 2 ;DISPLAY WHAT WE MAPPED 

* LOAD :F1 :CARS 

*DEFINE .START = CS:IP ;HANDY SYMBOL FOR RESTARTING 

*:TYPES ;MACRO FOR TYPE DEFINITIONS 
*SYMBOLS 

♦LINES ;DISPLAY SYMBOL AND LINE NUMBER TABLES 

*EM ;END OF MACRO INIT 

DEFINE MACRO EXAM 

* REPEAT 

♦STEP 

♦IF CS = SEG(.DISPLAY) AND IP = OFF(.DISPLAY) THEN 
♦WRITE 'CALL DISPLAY' 

*:POP86 IP * ; RESTORE RETURN ADDRESS 

*SP = SP + 2T ;DISCARD PARAMETER 

*ORIF CS = SEG(. DELAY) AND IP = OFF(. DELAY) THEN 
♦WRITE 'CALL DELAY' 
*:POP86IP 
*SP = SP + 2T 

*ORIF CS = SEG(..CARS#30) AND IP = OFF(..CARS#30) THEN 
♦WRITE 'STARTING MAIN LOOP' 

*ORIF CS = SEG(..CARS#34) AND IP = OFF(..CARS#34) THEN 
♦WRITE 'START OF IF TEST' 

* VARIABLES 

♦ORIF CS = SEG(.CYCLE) AND IP = OFF(.CYCLE) THEN 
♦WRITE 'CALL CYCLE' 
ENDIF 

ENDREPEAT 

EM ;END OF MACRO EXAM 
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6 Macro VARIABLES employs the WRITE command to display the key program 
variables with identifiers. The general syntax of WRITE is: 

WRITE element [, element]... 

The elements to be "written" (displayed at the console) can be strings (e.g., 
'SIDETIME') enclosed in single quotes, expressions, or constants of the form 
BOOL expression . Two or more elements can be combined by listing them in 
the order you desire, separated by commas. The strings in our commands serve 
to label the displays. 

VARIABLES also uses typed memory references; they have the format: 
\symbol-name 

Note that each of the symbol names in VARIABLES must be assigned a type 
(by macro TYPES) before LOOK can be called. Then, the typed reference pro- 
duces the contents of the given address. For example, if symbol .A is the address 
of a variable of type BYTE, !A means the same thing as BYTE. A; if .A is a 
WORD-type variable, however, ! A means WORD. A. 

The display produced by VARIABLES is shown in session 2 below. 

7 Macro TEST combines several macros and simple commands in a test suite. 
First we initialize the system by executing GO FROM START TILL ..CARS#30 
EXECUTED. Statement #30 in the beginning of the main loop. 

Next, TEST uses a parameter to assign a value to CARS WAITING. When we 
call TEST, we supply any value we wish as a parameter. 

Last, TEST calls EXAM to single step through the program displaying any calls 
that occur. 

8 The DIR MAC command produces a display of the titles of all the macros we 
defined, in the order they were defined. 

9 To display the definition of any macro, use a command with the form: 

MACRO macro-name 
Using this command, we display the definition of macro SETIP. 

10 We save our macro definition on a permanent file for use in later sessions. 

1 1 The EXIT command closes all files and returns us to ISIS-II (hyphen prompt). 
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6 'DEFINE MACRO VARIABLES 

•'WRITE 'LIGHTSTATUS = 'JLIGHTSTATUS,', CARSWAITING = 'JCARSWAITING 
•'WRITE 'MAINCYCLELENGTH = 'JMAINCYCLELENGTH,', MAINTIME = 'JMAINTIME 
•'WRITE 'SIDECYCLELENGTH = ',!SIDECYCLELENGTH,', SIDETIME = 'JSIDETIME 
•*EM ;END OF MACRO VARIABLES 

7 'DEFINE MACRO TEST 

•'GO FROM .START TILL ..CARS#30 EXECUTED 

•*!CARSWAITING = %0 

•'[VARIABLES 

•*:EXAM 

•*EM ;END OF MACRO TEST 

8 'DIRMAC 
PUSH86 
POP86 
SETIP 
TYPES 
INIT 
EXAM 

VARIABLES 
TEST 

9 'MACRO SETIP 
DEFINE MACRO SETIP 

CS = SEG (%0) 
IP = OFF(%0) 

EM ;END OF MACRO SETIP 

10 'PUT :F1 :TEST. INC MACRO 

11 'EXIT 
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Session 2 

0 We call up the ICE-86A program and specify a LIST file as before. 

1 The ENA EXP command enables the display of the macros so we can see the 
block of commands making up each macro. The expansion is disabled when the 
1CE-86A emulator is first invoked. 

The INCLUDE command causes the ICE-86A emulator to read commands 
from a file rather than from the console. The form of this command is just: 

INCLUDE \drive: filename 

In our case, the file :F1:TEST.INC contains the macro definitions from 
session 1 . Thus, when we enter the command: 

INCLUDE :F1:TEST.INC 

The ICE-86A emulator reads in all the macro definitions from PUSH86 through 
TEST, then returns control to the console. 
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-:F1:ICE86 

ISIS-II ICE-86/86A, V2.0 

LIST :F1 :DEC11 .LOG ;SESSION TWO 
ENA EXP 

INCLUDE :F1:TEST.INC 
DEFINE MACRO PUSH86 

*SP = SP - 2T ;MOVE POINTER TO NEW TOP OF STACK 
'WORD SS:SP = %0 ;PUSH PARAMETER ON STACK 
*EM ;END OF MACRO PUSH86 

DEFINE MACRO POP86 

*%0 = WORD SS:SP ;POP PARAMETER OFF STACK 

*SP = SP + 2T ;MOVE POINTER TO NEW TOP OF STACK 

*EM ;END OF MACRO POP86 

DEFINE MACRO SETIP 

*CS = SEG(%0) 

*IP = OFF(%0) 

*EM ;END OF MACRO SETIP 
DEFINE MACRO TYPES 

'TYPE .MAINTIME = BYTE ;FROM PLM LISTING 
'TYPE .SIDETIME BYTE ;FROM PLM LISTING 
'TYPE .MAINCYCLELENGTH = BYTE ;FROM PLM LISTING 
*TYPE .SIDECYCLELENGTH = BYTE ;FROM PLM LISTING 
'TYPE .CARSWAITING = BYTE ;FROM PLM LISTING 
*TYPE .LIGHTSTATUS = BYTE ;FROM PLM LISTING 
*EM ;END OF MACRO TYPES 

DEFINE MACRO INIT 

'MAP 0 LENGTH 2 = ICE 0 ;MEMORY SPACE FOR CARS PROGRAM 

'MAP 0 LENGTH 2 ;DISPLAY WHAT WE MAPPED 

*LOAD:F1:CARS 

*DEFINE .START = CS:IP ;HANDY SYMBOL FOR RESTARTING 

*:TYPES ;MACRO FOR TYPE DEFINITIONS 

'SYMBOLS 

'LINES ;DISPLAY SYMBOL AND LINE NUMBER TABLES 

*EM ;END OF MACRO INIT 

DEFINE MACRO EXAM 

*REPEAT 

'STEP 

'IF CS = SEG(. DISPLAY) AND IP = OFF(. DISPLAY) THEN 
*WRITE 'CALL DISPLAY' 

*:POP86 IP ; RESTORE RETURN ADDRESS 

*SP - SP + 2T ;DISCARD PARAMETER 

*ORIF CS = SEG(. DELAY) AND IP = OFF(. DELAY) THEN 
'WRITE 'CALL DELAY' 
*:POP86IP 
*SP = SP + 2T 

*ORIF CS = SEG(..CARS#30) AND IP = OFF(..CARS#30) THEN 
*WRITE 'STARTING MAIN LOOP' 

*ORIF CS = SEG(..CARS#34) AND IP = OFF(..CARS#34) THEN 

*WRITE 'START OF IF TEST' 

'-.VARIABLES 

*ORIF CS - SEG(.CYCLE) AND IP = OFF(. CYCLE) THEN 

'WRITE 'CALL CYCLE' 

*ENDIF 

'ENDREPEAT 

*EM ;END OF MACRO EXAM 

DEFINE MACRO VARIABLES 

'WRITE 'LIGHTSTATUS = '.ILIGHTSTATUS,', CARSWAITING = 'JCARSWAITING 
'WRITE 'MAINCYCLELENGTH = 'JMAINCYCLELENGTH,', MAINTIME = 'JMAINTIME 
'WRITE 'SIDECYCLELENGTH = 'JSIDECYCLELENGTH,', SIDETIME = 'JSIDETIME 
*EM ;END OF MACRO VARIABLES 
DEFINE MACRO TEST 

'GO FROM .START TILL ..CARS#30 EXECUTED 
*!CARSWAITING = %0 
VARIABLES 
EXAM 

EM ;END OF MACRO TEST 
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2 We invoke macro INIT with a macro call of the form: 

-.macro-name 
In our example, the call is: 
:INIT 

First, the macro is ' Expanded' ' to form a block of executable commands. The 
expansion is displayed since we previously enabled the display. The expansion 
of INIT involves expanding the macro TYPES at the point that TYPES is called 
within INIT (see the definition of INIT on the previous page). As INIT is 
expanded, each command is checked for syntax; any error here would abort the 
macro call. However, no errors occur and we reach the EM token marking the 
end of the macro expansion. 

3 The commands in INIT now execute. The MAP commands allocate space in 
ICE memory for our code and display the resulting map (T indicates decimal 
radix): 

0000THCE 0000T 0001 T=ICE 0001 T 

The SYMBOLS command displays the symbol table; the listing shows the sym- 
bol names and corresponding addresses. We see that .START is present in an 
unnamed module at the head of the table, and other symbols are listed in the 
order they appear within the two program modules, ..CARS and ..DELAY. 
Note the type specifications on the program variables named in the macro 
TYPES. 

The LINES command displays the statement numbers and corresponding 
addresses from CARS. DELAY has no line numbers because the assembler does 
not produce a line number table. 
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*:INIT 

•*MAP0 LENGTH 2 = ICE 0 
•*MAP0 LENGTH 2 
•*LOAD:F1:CARS 
•'DEFINE .START = CS:IP 
•*:TYPES 

••*TYPE .MAINTIME = BYTE 
••*TYPE .SIDETIME - BYTE 
••*TYPE .MAINCYCLELENGTH = BYTE 
••*TYPE .SIDECYCLELENGTH BYTE 



••*TYPE.CARSWAITING = 
••*TYPE .LIGHTSTATUS = 
••*EM 

•'SYMBOLS 

•'LINES 

•*EM 



BYTE 
BYTE 



;MEMORY SPACE FOR CARS PROGRAM 
;DISPLAY WHAT WE MAPPED 

;HANDY SYMBOL FOR RESTARTING 
;MACRO FOR TYPE DEFINITIONS 
;FROM PLM LISTING 
;FROM PLM LISTING 

;FROM PLM LISTING 
;FROM PLM LISTING 



FROM PLM LISTING 
FROM PLM LISTING 
END OF MACRO TYPES 

;DISPLAY SYMBOL AND LINE NUMBER TABLES 
;END OF MACRO INIT 



3 0000THCE 0000T 0001 T=ICE 0001 T 
•CODE=0020:0000H 
•CONST=002F:000CH 
•DATA=002F:000EH 
•STACK=0030:0002H 
•MEMORY=0031:0000H 
•??SEG=0031:0000H 
•ABS_0=0000H 
•CGROUP=0000H 
•DGROUP=0000H 
•START=0202H 
MODULE. .CARS 
•MEMORY=0310H 
•MAINTIME=02FEH OF BYT 
•SIDETIME=02FFH OF BYT 
•MAINCYCLELENGTH=02FCH OF BYT 
•SIDECYCLELENGTO-02FDH OF BYT 
•CARSWAITING=0300H OF BYT 
•LIGHTSTATUS=0301H OF BYT 
•SIDESTREETCAR=028DH 
•DISPLAY=0296H 
•CYCLE=02A5H 
MODULE ..DELAY 
•DELAY=02D8H 
•LAB1=02DFH 
•LAB2=02E1H 
•M=0000H 

•MEMORY_LABEL=0031 :0000H 

•STACK_BASE=0030:000CH 

•TEMP=0020:00FBH 

MODULE. .CARS 

#1=028DH 

#2=028DH 

#3=028DH 

#4=028DH 

#5=028DH 

#6=028DH 

#7=028DH 

#8=0290H 

#9=0294H 

#10=0296H 

#11=0296H 

#12=0296H 

#13=0296H 

#14=0299H 

#15=0299H 

#16=02A1H 

#17=02A5H 

#18=02A8H 

#19=02ADH 

#20=02B2H 

#21=02BFH 

#22=02C3H 

#23=02C9H 

#24=02CDH 

#25=02D0H 
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4 We now invoke macro TEST to exercise the program logic. We wish to 
demonstrate that the code will branch to CYCLE when either of the following 
two conditions is true: 

1) CARSWAITING = 1 AND MAINTIME>= 16 seconds 

2) CARSWAITING >= 2 AND MAINTIME >= 8 seconds 

In the definition of TEST (look back at step 1) the second command is: 
!CARSWAITING = %0 

The parameter %0 lets us set the contents of CARSWAITING to any BYTE 
quantity we require. Thus we test condition 1 by our command: 

TEST 1 

This results in the expansion: 
!CARSWAITING = 1 

The expansion of TEST involves the expansion of the macros VARIABLES and 
EXAM at the point each is called in the body of TEST. 

Macro TEST now begins to execute. To help us follow the displays, we can iden- 
tify some key addresses in the portions of code we are checking, as shown in 
table 3-1. 



Table 3-1 . Key Addresses in CARS Logic 



ADDRESS (IP) 


LINE # 


PLACE IN 


NUMBER 


CARS CODE 


0002H 


#27 


START OF MAIN PROGRAM (.START) 


021 FH 


#30, 31 


START OF MAIN 'DO' BLOCK 


0236H 


#34 


START OF IFJEST 


0276H 


#35, 36 


START OF CONDITIONAL 'DO' BLOCK 


027EH 


#37 


POINT OF RETURN FROM 'CALL CYCLE' 


0288H 


#39, 40 


END OF BOTH CONDITIONAL AND MAIN 'DO' BLOCKS 


0296H 


#13 


BEGINNING OF DISPLAY (SKIPPED) 


02A5H 


#17 


BEGINNING OF CYCLE 


02D5H 


#26 


END OF CYCLE 


02D8H 


(#17) 


BEGINNING OF DELAY (SKIPPED) 
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#26=02D5H 
#27=0202H 
#28=021 5H 
#29=021 AH 
#30=021 FH 
#31=021FH 
#32=0226H 
#33=022CH 
#34=0236H 
#35=027BH 
#36=027BH 
#37=027EH 
#38=0283H 
#39=0288H 
#40=0288H 
#41=028BH 
MODULE. .DELAY 



:TEST 1 

GO FROM .START TILL ..CARS#30 EXECUTED 

ICARSWAITING = 1 

•.VARIABLES 

WRITE 'LIGHTSTATUS = \!LIGHTSTATUS,', CARSWAITING = ICARSWAITING 
WRITE 'MAINCYCLELENGTH = ',!MAINCYCLELENGTH,', MAINTIME = 'JMAINTIME 
WRITE 'SIDECYCLELENGTH = ', '.SIDECYCLELENGTH,', SIDETIME = ',!SIDETIME 
EM ;END OF MACRO VARIABLES 
EXAM 
REPEAT 
STEP 

IF CS = SEG(. DISPLAY) AND IF = OFF(. DISPLAY) THEN ' 
'WRITE 'CALL DISPLAY' 

*:POP86IP ;RESTORE RETURN ADDRESS 

•'IP = WORD SS:SP ;POP PARAMETER OFF STACK 

•*SP = SP + 2T ;MOV POINTER TO NEW TOP OF STACK 

•*EM ;END OF MACRO POP86 

*SP = SP + 2T ;DISCARD PARAMETER 

*ORIF CS = SEG(. DELAY) AND IP = OFF(. DELAY) THEN 
'WRITE 'CALL DELAY' 
*:POP86IP 

•'IP = WORD SS:SP ;POP PARAMETER OFF STACK 

•*SP = SP + 2T ;MOVE POINTER TO NEW TOP OF STACK 

•*EM ;END OF MACRO POP86 

*SP = SP + 2T 

*ORIF CS = SEG(..CARS#30) AND IP = OFF(..CARS#30) THEN 
'WRITE 'STARTING MAIN LOOP' 

*ORIF CS = SEG(..CARS#34) AND IP = OFF(..CARS#34) THEN 
'WRITE 'START OF IF TEST' 
'•.VARIABLES 

•'WRITE 'LIGHTSTATUS = \!LIGHTSTATUS,\ CARSWAITING = ', ICARSWAITING 
•'WRITE 'MAINCYCLELENGTH = ',! MAINCYCLELENGTH,', MAINTIME = 'JMAINTIME 
•'WRITE 'SIDECYCLELENGTH = 'JSIDECYCLELENGTH,', SIDETIME = 'JSIDETIME 
•'EM ;END OF MACRO VARIABLES 

*ORIF CS =(.CYCLE) AND IP = OFF(.CYCLE) THEN 
'WRITE 'CALL CYCLE' 
'ENDIF 
ENDREPEAT 
EM ;END OF MACRO EXAM 
EM ;END OF MACRO TEST 
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5 The messages EMULATION BEGUN' and 'EMULATION TERMINATED, 
CS:IP = 0000:0223' are produced by the command 'GO FROM .START TILL 
..CARS#30 EXECUTED.' 

6 The next three display lines are produced by macro VARIABLES. We see that 
LIGHTSTATUS is 1 (main street green), and that CARSWAITING has 
been set to 1 by the command MCARSWAITING = V in TEST. 
MAINCYCLELENGTH and SIDECYCLELENGTH are constants at 8 and 5, 
respectively. MAINTIME is zero. 

7 This is the beginning of the REPEAT loop in macro EXAM. The first STEP 
ends with address 0296H in the instruction pointer; this is the beginning of 
DISPLAY and macro EXAM displays the 'CALL DISPLAY' message. 

8 When the beginning of DELAY appears in CS.TP, EXAM displays 'CALL 
DELAY'. 

9 Address 0236H is the address of the first instruction generated by the IF 
statement on line #34 of CARS. EXAM displays the message 'START OF IF 
TEST', and also displays (via a call to macro VARIABLES) the values of the 
variables involved in the IF condition. The only change since the last such 
display is that MAINTIME has been incremented to 1 . 
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5 EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0223H 

6 LIGHTSTATUS = 0001H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0000H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 

7 EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 

8 CALL DELAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 

9 START OF IF TEST 

LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0001H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS.IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS:IP 
EMULATION BEGUN 
EMULATION TERMINATED, CS.IP 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0252H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0257H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0259H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:025DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0261H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0263H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0265H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0267H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0269H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026EH 



=0000:023BH 

=0000:023DH 

=0000:023FH 

=0000:0240H 

=0000:0244H 

=0000:0245H 

=0000:0249H . 

=0000:024BH 

=0000:024DH 

=0000:024EH 

=0000:024FH 

=0000:0251 H 



Sample ICE-86A Sessions at the Terminal 



ICE-86A 



10 The previous thirty STEPs comprise the IF-test. Address 0278H is the end of the 
IF test, and 0288H is the end of the main loop. Since address 027BH did not 
appear, we know that the conditional loop did not execute. 

1 1 Here we are at the beginning of the main loop in CARS. 

12 This time through the IF test, MAINTIME is 2. We omit most of the STEPs 
through the test (address 023BH to 0278H) from the text; these are identical to 
the series shown at step 9. 

1 3 The start of the main loop again; still no light change. 
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EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0271H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0272H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0274H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0276H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0278H 
10 EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 



11 EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0223H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 

12 START OF IF TEST 

LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0002H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023FH 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0276H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
13 STARTING MAIN LOOP 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0223H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
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14 MAINTIME equals 3; still a long way to go until MAINTIME equals 16. We 
now omit all steps from the text except the beginning and end of the IF test, so 
that we can concentrate on the value of MAINTIME. 

15 MAINTIME equals 4. 

16 MAINTIME equals 5. 
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EMULATION BEGUN 

EMULATION TERMINATED, CS:IP^00Q0:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
14 LIGHTSTATUS - 000*1 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0003H 
SIDECYCLELENGTH = 0005H, SIDETIME = Q070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 



• 

EMULATION TERMINATED, CS:IP=00Q0:0276H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
15 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0004H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
16 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0005H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 
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17 MAINTIME equals 6. 

18 MAINTIME equals 7. 

19 MAINTIME equals 8. 
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EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021 FH 
STARTING MAIN LOOP 
EMULAITON BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
17 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0006H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
18 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0007H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
19 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0008H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 
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20 MAINTIME equals 9. 

21 MAINTIME equals lO(OAH). 
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EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
20 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0009H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
21 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000AH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
• EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 
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22 MAINT1ME equals 1 1 (OBH). 

23 MAINTIME equals 12 (OCH). 

24 MAINTIME equals 13 (ODH). 
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EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
22 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000BH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=D000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
23 LIGHTSTATUS = 0001 H, CARSWAITING = 0001H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000CH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
24 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000DH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARING MAIN LOOP 
EMULATION BEGUN 
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25 MA1NTIME equals 14 (OEH). 

26 MAINTIME equals 15 (OFH). 

27 Finally, MAINTIME equals 16 or two times MAINCYCLELENGTH. This 
time the condition 'CARSWAITING = 1 AND MAINTIME >= 2 * MAIN- 
CYCLELENGTH' is TRUE and we should see a call to CYCLE at the end of 
the IF test. 
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EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
25 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000EH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
26 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 000FH 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0278H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 
STARTING MAIN LOOP 
EMULATION BEGUN 



EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
27 LIGHTSTATUS = 0001 H, CARSWAITING = 0001 H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0010H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0070H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0240H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0244H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0245H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0249H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024BH 
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28 Address 027BH in the beginning of the conditional 'DO' loop. 

29 Here is the beginning of CYCLE (0A7H). CYCLE is a loop controlled by the 
statement 'DO WHILE SIDETIME <= SIDECYCLELENGTH'; 
SIDECYCLELENGTH is 5, so the loop should exit when SIDETIME equals 6. 
We could have included ICE-86A commands in macro EXAM to examine 
CYCLE more closely (LIGHTSTATUS should be set to zero, and SIDETIME 
should increment on each iteration). In our example, however, we simply wait 
for CYCLE to return to the main program. The rest of the display on this page 
shows two iterations of CYCLE. We have omitted the printout of the remaining 
iterations. 



3-32 



ICE-86A 



EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0251H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0252H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0257H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0259H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:025CH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:025DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0261H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0263H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0265H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0267H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0269H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:026FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0271H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0272H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0274H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0276H 
EMULATION BEGUN 
28 EMULATION TERMINATED, CS:IP = 0000:027BH 
EMULATION BEGUN 



29 EMULATION TERMINATED, CS:IP=0000:02A5H 
CALL CYCLE 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02A6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02A8H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02ADH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B2H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BAH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BFH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C0H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C5H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
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30 Address 02D5H is the end of CYCLE. Two steps later, 027EH is the return 
address from the call to cycle. 
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EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02CDH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B2H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BAH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BFH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C0H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C5H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02CDH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B2H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BAH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BFH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C0H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C5H 



EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C5H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02C6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02CDH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B2H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BAH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BCH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D0H 
EMULATION BEGUN 
30 EMULATION TERMINATED, CS:IP=0000:02D5H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:027EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0283H 
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3 1 Here we are back at the start of the main loop. 

32 The display of variables shows LIGHTSTATUS at 1 and CARSWAITING at 
zero. SIDETIME is 6 as we expected. MAINTIME is 1 and will continue to 
increment as long as we allow the program to emulate. 

33 We consider this test 'successful', and abort the emulation by pressing the ESC 
key. 

34 Now to test the second condition. The macro call 'TEST V produces an 
expansion of macro TEST; this time CARSWAITING is set to 2. Otherwise, the 
expansion produces an executable macro identical to 'TEST 1' shown in step 4. 
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EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 

31 STARTING MAIN LOOP 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0223H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

32 LIGHTSTATUS = 0001 H, CARSWAITING = 0000H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0001 H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023DH 

33 PROCESSING ABORTED 



34 



TEST 2 

k GO FROM .START TILL ..CARS#30 EXECUTED 

JCARSWAITING = 2 

^VARIABLES 

•♦WRITE 'LIGHTSTATUS =' JLIGHTSTATUS,', CARSWAITING = 'JCARSWAITING 
'WRITE 'MAINCYCLELENGTH =' JMAINCYCLELENGTH,', MAINTIME = 'JMAINTIME 
'WRITE 'SIDECYCLELENGTH =', .'SIDECYCLELENGTH,', SIDETIME =' JSIDETIME 
EM ;END OF MACRO VARIABLES 
EXAM 

•* REPEAT 

••'STEP 

••*IF CS =SEG(.DISPLAY) AND IP = OFF(.DISPLAY) THEN 
•••♦WRITE 'CALL DISPLAY' 

•••*:POP86IP ;RESTORE RETURN ADDRESS 

••••*IP = WORD SS:SP ;POP PARAMETER OFF STACK 
••••*SP = SP + 2T ;MOVE POINTER TO NEW TOP OF STACK 

••••*EM ;END OF MACRO POP86 

•••*SP = SP + 2T ;DISCARD PARAMETER 

•••*ORIF CS = SEG(. DELAY) AND IP = OFF(. DELAY) THEN 
•••'WRITE 'CALL DELAY' 
•••*:POP86IP 

••••*IP = WORDSS:SP ;POP PARAMETER OFF STACK 
••••*SP = SP + 2T ;MOVE POINTER TO NEW TOP OF STACK 

••••*EM ;END OF MACRO POP86 

•••*SP = SP + 2T 

•••*ORIF CS = SEG(..CARS#30) AND IP = OFF(..CARS#30) THEN 
•••♦WRITE 'STARTING MAIN LOOP' 

•••*ORIF CS = SEG(..CARS#34) AND IP = OFF(..CARS#34) THEN 

•••♦WRITE 'START OF IF TEST' 

•••♦.VARIABLES 

••♦WRITE 'LIGHTSTATUS = ',! LIGHTSTATUS,', CARSWAITING = 'JCARSWAITING 
••••♦WRITE 'MAINCYCLELENGTH = ', 'MAINCYCLELENGTH, 1 , MAINTIME = 'JMAINTIME 
••••♦WRITE 'SIDECYCLELENGTH = ' JSIDECYCLELENGTH,', SIDETIME = ' JSIDETIME 
••••*EM ;END OF MACRO VARIABLES 
•••*ORIF CS = SEG(.CYCLE) AND IP = OFF(.CYCLE) THEN 
•••♦WRITE 'CALL CYCLE' 
•••♦ENDIF 
••♦ENDREPEAT 
EM ;END OF MACRO EXAM 
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35 We emulate to the start of the main loop, as before. This time CARSWAITING 
is 2, and we should CALL CYCLE as soon as MA1NTIME equals 8. We omit 
the intermediate steps. 

36 MAINTIME is 8, equal to MAINCYCLELENGTH. 
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35 EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0223H 
LIGHTSTATUS = 0001 H, CARSWAITING = 0002H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0000H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0296H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 

LIGHTSTATUS = 0001 H, CARSWAITING = 0002H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0001 H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 



36 START OF IF TEST 

LIGHTSTATUS = 0001 H, CARSWAITING = 0002H 
MAINCYCLELENGTH = 0008H, MAINTIME = 0008H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0240H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0244H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0245H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0249H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:024FH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0251H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0252H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0257H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0259H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:025BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:025CH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:025DH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0261H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0263H 
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37 And here's the beginning of CYCLE. Once more we omit the steps in CYCLE 
from the text. 

38 This is the end of CYCLE, and the return to the main program. 

39 Back to the start of the main loop. 
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EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS: 


:IP= 


=0000 


:0265H 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS: 


;IP= 


=0000 


:0267H 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS: 


:IP= 


=0000 


:0269H 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS: 


:IP= 


=0000 


:026BH 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS: 


:IP= 


=0000 


:026DH 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS: 


:IP= 


=0000 


:026EH 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS: 


:IP= 


=0000 


:026FH 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS 


:IP= 


=0000 


:0271H 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS 


:IP= 


=0000 


:0272H 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS 


:IP= 


=0000 


:0274H 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS 


:IP= 


=0000 


:0276H 


EMULATION 


BEGUN 










EMULATION 


TERMINATED, 


CS 


:IP= 


=0000 


:027BH 


EMULATION 


BEGUN 










37 EMULATION 


TERMINATED, 


CS 


:IP= 


=0000 


:02A5H 


CALL CYCLE 










EMULATION 


BEGUN 











EMULATION TERMINATED, CS:IP=0000:02B6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BAH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02BCH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02DOH 
EMULATION BEGUN 

38 EMULATION TERMINATED, CS:IP=0000:02D5H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D6H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:027EH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0283H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0288H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:021FH 

39 STARTING MAIN LOOP 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0223H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0298H 
CALL DISPLAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0228H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0229H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:02D8H 
CALL DELAY 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0230H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0232H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:0236H 
START OF IF TEST 
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40 We consider this test 'successful', abort emulation, and exit from the ICE-86A 
emulator back to ISIS-II (hyphen prompt). 
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40 LIGHTSTATUS = 0001 H, CARSWAITING = 0000H 
MAINCYCLELENGTH = 0008H, MAIN-TIME = 0001 H 
SIDECYCLELENGTH = 0005H, SIDETIME = 0006H 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023BH 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:023DH 

PROCESSING ABORTED 
* 

*EXIT 



3-43 



CHAPTER 4 
ELEMENTS OF THE ICE-86A™ 
COMMAND LANGUAGE 



Introduction 

The ICE-86A software provides you with an easy-to-use English language command 
set for controlling ICE-86A execution in a variety of functional modes. 

The ICE-86A commands enable you to: 

• Initialize the 1CE-86A system, map your program to memory in your system, 
ICE-86A memory, disk memory, or in the Intellec Microcomputer Development 
System, and load your program from a diskette file. 

• Specify starting and stopping conditions for emulation. 

• Execute real-time emulation of your software (and hardware). 

• Execute single-step emulation. 

• Specify conditions for trace data collection. 

• Collect and display trace data on conditions occurring during emulation. 

• Display and alter 8086 registers, memory locations, and I/O ports. 

• Copy the (modified) program from mapped memory to a diskette file, and exit 
the ICE-86A system. 

An example of one complete ICE-86A command, in this case one of the forms of the 
GO command, is shown in figure 4-1. This command causes emulation to start and 
specifies the conditions that will halt emulation. The command is made up of ten 
separate "words" (character strings that are referred to as tokens): GO, FROM, 
0123H, TILL, 1000H, TO, 1100H, READ, USING, and CS. Each of these tokens 
provides a particular element of information necessary to inform the ICE-86A 
emulator of the specific command functions (see table 4-1). The tokens also form 
the following command components: the FROM clause, match-range, match-status, 
segment-register-usage, match-condition, and TILL clause. This string of tokens 
requests the ICE-86A emulator to start emulation at location 0123H and to continue 
emulation until data is read from any memory location within the match-range (par- 
tition) of addresses 1000H through 1 100H using the CS segment register in the effec- 
tive address calculation. Every ICE-86A command is composed of one or more such 
tokens. 




USING 
token9 



CS 
tokenIO 



segment- 
register- 
usage 



match-condition 



y 

TILL-clause 



Figure 4-1 . Example of a GO Command 
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Table 4-1 . Definition of GO Command Functions 



Token 
Number 


Name 


Function 


1 




GO command specifier; requests and 
initiates emulation. 


2 


FROM 


Indicates that the next token or 
expression is the starting address for 
emulation. 


3 


0123H 


Starting address in hexadecimal 
radix. 


2,3 


FROM clause 


FROM 0123H causes the instruction 
pointer (IP) to be loaded with 0123H, 
the starting address for emulation. 
Also, the code segment register (CS) 

lo lUdUtJU Willi U. 


4 


TILL 


Indicates that the breakpoint (halting) 
parameters are to follow. 


5 


1000H 


Specifies the lowest address of a 
range of memory locations. This 

pcUcUllclcM lo lllcJ lUWcl UUUilU Ul a 

memory partition. 


6 


TO 


Indicates that the upper bound 
(address) of the range (partition) of 
memory locations is to follow. 


7 


I luun 


Specifies the highest address of the 
range of memory locations. 


£ R 7 
0,0,/ 


match-range 


Emulation is to halt if an access to any 
memory location whose address falls 
within the range of 1000H to 1100H. 


o 
0 


dp a n 
ntAU 


Emulation is to halt if any of the above 
memory locations are read. 


9 


USING 


Indicates a segment register is to 
follow. 


10 


CS 


1 lie ooucJ seyrnerii regioier^oo/ musi 
be used in the effective address 
calculation in order to match. 


9,10 


segment-register-usage 


Emulation is to halt if the CS is used. 


5thru 10 


match-condition 


Emulation is to halt if data is read 
from anv mpmorv location in thp 
match-range. 


4 thru 10 


TILL clause 


TILL 1000H TO 1100H READ USING CS 
specifies that the emulation is to halt 
whenever the match-condition is 
met. This clause is also called the 
'GO-register' in the ICE-86A 
language. 



Note: The match-condition consists of the three sub-conditions: match-range (tokens 
5,6,7), match-status (token 8), and segment-register-usage (tokens 9,10). All 
three of these conditions must be matched for emulation to halt. 



As briefly indicated in figure 4-1, the ICE-86A commands are written in an ICE-86A 
command language composed of a unique character set and vocabulary of tokens 
augmented by a particular set of syntactic rules. The tokens are constructed from the 
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character set and in turn are used to construct commands. The tokens consist of a set 
of predefined literals augmented by user-defined literals that provide symbolic 
references. Table 4-1 contains the definition of each token shown in figure 4-1 . 

The purpose of this chapter is to present a detailed specification of the ICE-86A 
command language. The language consists of two parts, a vocabulary that is used to 
convey elements of information to the ICE-86A emulator and a "grammar" (syn- 
tactic rules) used to group command words into command constructs such as the 
FROM clause shown in figure 4-1. The remainder of this chapter is devoted to the 
presentation of the command language. The initial discussion deals with class-names 
and the notation used to describe the language and will include a listing of the syn- 
tactic rules that govern command construction. This will be followed by a presenta- 
tion of the command literals (keywords) and a discussion of symbolic references. 

Notation and Conventions Used in This Manual 

This manual employs a set of notational symbols and conventions to describe the 
structure of commands and other language constructs. The features of this notation 
are described in the following paragraphs. Table 4-2 contains the notational symbols 
used to define and describe the command structures. 



Table 4-2. Notational Symbols 


Symbol 


Meaning 




"is defined as" 




Mutual exclusion 




May be repeated indefinitely 


{ >... 


At least one entry must be selected. If more than one entry is 
selected, they may be selected in any order. 


{ > 

[ I- 


One of the enclosed entries must be selected. 

Selection of the enclosed entries is optional. If more than one entry is 
selected, they may be selected in any order. 


[ 1 


Selection of the enclosed entries is optional but only one entry may 
be selected. If this symbol encloses only one entry, that entry is 
optional. 



In addition to the above notational symbols, a set of class-names are used to assist in 
the definition and description of entities in the ICE-86A command language. Each 
class-name is an identifier for a specific set of characters, mnemonics, or constructs 
and is always shown in lower-case italics. Any character string not in lower-case 
italics is a specific character, mnemonic or construct. For example, the class-name 
segment-register refers to the entire class of segment registers. The character string 
CS refers to the Code Segment Register, which is one of the four segment registers. 

As shown in figure 4-1, the smallest meaningful unit of information contained 
within a command is a mnemonic character string that is the equivalent of a word. 
Examples are: GO, 0123H, and FROM. These mnemonics are assigned the class- 
name: token. In addition to these basic elements, the tokens are combined 
into multi-token forms such as the FROM clause and match-condition shown in 
figure 4-1 . 
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The ICE-86A vocabulary is made up of two classes of mnemonics: tokens and 
special-tokens: 

token = constant : : keyword : : symbol : : sfrv'ng : : operand 
special-token = operator : : punctuation-mark : : delimiter : : terminator 

The notational symbol (::) specifies mutual exclusion. That is, a token is a constant, 
or keyword or symbol or s£™# or operand. 

Each of the above classes of tokens and special-tokens is defined later in this chapter 
or in the next chapter in the discussion of expressions. 



Syntactic Rules Used in the Manual 

This manual employs a set of conventions to describe the structure of commands 
and other ICE-86A language forms. Items 1 and 2 below specify the use of class- 
names and tokens, respectively. The features of this notation system are as follows: 

1 . A lower-case italicized entry in the description of a command is the class-name 
for a set or class of tokens. To create an actual operable command, you must 
enter a particular member of this class. A class-name never appears in an actual 
operable command. For example, the lower-case entry: 

breakpoint-register 

means that the command will accept any of the three tokens: BRO, BR1 or BR 
(BR means BRO and BR1). Classes of tokens that have generalized usage, such 
as the classes of reference keywords and command keywords, are explained and 
assigned class-names in this chapter. Additional classes of tokens that appear in 
the syntax descriptions of particular commands are explained in the discussion 
of semantics that accompanies those commands. 

2. An upper-case entry is a token that must be used literally as given. A valid 
abbreviation of that token may substitute for the full token as given. The token 
may be a command word, or it may be a particular member of a class of 
references. For example, the upper-case entry 

DEFINE 

is a command word that must be used as given unless abbreviated. The 
abbreviation DEF may be used in place of DEFINE. As another example, the 
upper-case entry 

BR1 

means that breakpoint register 1 must be named as and where given. 

3. A single required entry is shown without any enclosures, whereas a single 
optional entry is denoted by enclosing in brackets. For example, in the com- 
mand syntax 

STEP [FROM address] 

the token STEP is required. The significance of the brackets around the entry: 
FROM address means that its selection is optional in this command. 

4. Where only one entry must be selected from a menu of two or more entries, the 
choices for the required entry are denoted by enclosing them in braces. For 
example, 



| FRAME \ 
THA0E { INSTRUCTION ( 



indicates that FRAME or INSTRUCTION must be selected; the tokens TRACE 
and = are required as given. 
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5. An optional entry is enclosed in brackets [ ]. For example, 
STEP [FROM address] 

means that the command word STEP is required but the clause FROM address 
is optional in this command. 

Where a choice exists for an optional entry, the choices are given in a vertical 
arrangement enclosed in brackets. For example, the command 

OF BYTE 



DEFINE [module-name] symbol = expr 



OF WORD 
OF SINTEGER 
OF INTEGER 
OF POINTER 
OF REAL 



means that DEFINE, symbol, =, and expr are required in this command and 
module-name is optional. The brackets around the vertical arrangement of 
memory type designators denotes that selection of a memory type designator is 
optional but only one designator may be selected per DEFINE command. 



6. A group of required inclusive choices is given in a vertical arrangement and 
enclosed in braces ( ) followed by a repeat symbol (...). "Inclusive" means 
that more than one of the items can be entered in the same command, and items 
can appear in any order; no item can be entered more than once. The menu of 
inclusive items represents a required entry or entries. For example: 

(READ 
WRITTEN 
INPUT 
OUTPUT 
FETCHED 
HALT 
ACKNOWLEDGE 

This notation indicates that one or more items from the vertical list is required 
to specify a match-status-list. If more than one item is used, they can be in any 
order and must be separated by commas. 

To complete the example: 

WRITTEN, HALT, READ, FETCHED 

is a valid match-status-list. 




7. A group of optional inclusive choices is given in a vertical arrangement and 
enclosed in brackets and followed by a repeat symbol (...). "Inclusive" means 
that more than one of the items can be entered in the same command, and the 
items can appear in any order; no item can be used more than once. The menu 
of inclusive items represents an optional entry or entries. For example: 



LOAD path-name 



NOCODE 

NOSYMBOL 

NOLINE 



This notation indicates that none, one, or more than one choice of NOCODE, 
NOSYMBOL, and/or NOLINE may be included in one LOAD command; if 
more than one is used, the entries can be in any order. 

To complete the example: 

LOAD :F0:TEST NOSYMBOL NOCODE NOLINE 

is a valid command. 
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Where mutually exclusive entries can be shown on one line, the following 
shorthand notation can be used: 

SUFFIX = Y::0::Q::T::H 

This example is equivalent to 
/ < 
Y 

SUFFIX = 



Where an entry can be repeated indefinitely at the user's option, the syntax 
is notated by enclosing the repeatable entry in brackets [ ] followed by an 
ellipsis ... .For example, 

operand [operator operand ] ... 

indicates that operator operand can be repeated as many times as desired. 



Character Set 

The valid characters in the IGE-86A command language include upper and lower 
case alphabetic ASCII characters A through Z and the set of digits 0 through 9. The 
space serves as a delimiter for tokens, and carriage-return/line-feed characters are 
also valid, delimiting command lines. A question mark, ?, @ sign, and $ sign are 
also valid in user-defined names entered in the command language. 

The algebraic operators + and - (binary and unary), the asterisk (*), and slash (/), 
relational operators (=, <, >), the ampersand, semicolon, colon, period, paren- 
theses, exclamation mark (!), pound sign (#), percent sign (%) and comma constitute 
the only other valid ASCII characters for the ICE-86A emulator. Non-printing 
characters are ignored; tabs, form feed, etc. are treated as spaces. Other characters 
are errors. 

alphabetic characters: 

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz®? 
numeric characters: 

0123456789 (A BCDEF: hexadecimal characters) 
special characters: 

+ -< = >$'&).(;*/#!:,% 

This character set is used to construct the vocabulary that constitutes the command 
language. 



Introduction to Tokens 

A token in ICE-86A command language is roughly equivalent to a 'word' in the 
English language. It consists of a string of alphanumeric characters that may be 
augmented by a one or two special character prefix that serves as a token identifier. 
Tokens are divided into the following types: keywords, user-names, and special- 
tokens. Examples are: 

REGISTERS, .START, ..MODULE, .SAM, 0400, 123AH. 
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Keywords 

The ICE-86A emulator recognizes a general class of predefined tokens that are fixed 
in the command language. They provide two functions. Reference keywords are 
used to specify locations having unique predefined functions. Command keywords % 
specify command type and subfunctions within a command. The following sections 
define and describe these keyword classes. Each class and associated keyword set is 
presented in the following paragraphs. Appendix A contains a listing of ICE-86A 
keywords and their abbreviations. 

The reason for discussing the various classes and subsets here is to smooth the later 
discussions of commands, where the class-names are used to show what elements 
may appear in specific commands. 



Reference Keywords 

The command language contains a set of system defined mnemonic tokens that are 
used to address system objects. Each device, such as the accumulator or a register, is 
assigned a specific mnemonic that is to be used to address and access the contents of 
that device. These identifiers are called reference keywords. Reference keywords are 
used in ICE-86A commands to refer to 8086 processor registers and flags, emulation 
registers, memory locations, and I/O ports. 

The total set of reference keywords is subdivided by types, each of which is refer- 
enced by a class name. Class names are always shown in lower case italics. For exam- 
ple, the class name general-register denotes the set of four 16-bit general work 
registers in the 8086 processor. A reference token is assigned to each element within 
the given class and is always shown in upper case. For example, 'RAX' denotes the 
contents of the accumulator (RAX register) of the general register set. 



Registers 

The register structure contains three files of four 16-bit registers, a set of 
miscellaneous registers, and a set of four pseudo-registers. The three files of registers 
are the general register file, the pointer and index file, and the segment register file 
(see table 4-3). The miscellaneous set consists of the instruction pointer, flag 
register, CAUSE register, OPCODE register, PIP register, TIMER register, 
HTIMER register, and BUFFERSIZE register. The pseudo-register set consists of 
the breakpoint and trace point registers. The miscellaneous register set and the 
pseudo-registers provide a variety of functions to the ICE-86A emulator that are 
described in the appropriate command sections of this manual. The register struc- 
tures are described in the following paragraphs. 



Table 4-3 . Classes of Hardware Elements 



Class Name 


Hardware Elements 


general-register 

pointer-register 

index-register 

segment-register 

status-register 

emulation-register 


8-bit and 16-bit work register 

16-bit address register 

16-bit address register 

16-bit segment reference register 

8-bit and 16-bit status registers 

breakpoint and tracepoint registers 
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General Register File. The RAX, RBX, RCX, and RDX registers compose the 
General Register File. These registers participate interchangeably in 8086 arithmetic 
and logical operations. These registers are assigned the following mnemonics: 

RAX: Accumulator Note: These are the 8086 AX, BX, CX, DX 

RBX: Base Register registers (i.e., the ICE-86A emulator 

RCX: Count Register appends 'R' to the 8086 names). 

RDX: Data Register 

The general registers are unique within the 8086 as their upper and lower bytes are 
individually addressable. Thus, each of the general registers contains two 8-bit 
register files called the H file and L file as illustrated below. 



H File L File 

15 8 7 0 



RAX: 


RAH 


RAL 


RBX: 


RBH 


RBL 


RCX: 


RCH 


RCL 


RDX: 


RDH 


RDL 



Pointer and Index Register File 



Pointer and Index Register File. The BP, SP, SI, and DI registers are called the 
Pointer and Index Register File. The registers in this group are similar in that they 
generally contain offset addresses used for addressing within a segment. They can 
participate interchangeably in 16-bit arithmetic and logical operations and can also 
be used in address computation. The mnemonics associated with these registers are: 



SP: Stack Pointer 
BP: Base Pointer 
SI: Source Index 
DI: Destination Index 

The pointer and index registers are illustrated below. 



15 

SP: 
BP: 
SI: 
DI: 



General Register File 



Segment Register File. The CS, DS, SS, and ES registers constitute the Segment 
Register File. These registers provide a significant function in the memory address- 
ing mechanisms of the 8086. They are similar in that they are used in all memory 
address computations. The mnemonics associated with these registers are: 



CS: Code Segment Register 
DS: Data Segment Register 
SS: Stack Segment Register 
ES: Extra Segment Register 
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The contents of the CS register define the current code segment. All instruction 
fetches are taken to be relative to CS using the instruction pointer (IP) as an offset. 

The contents of the DS register define the current data segment. All data references 
except those involving BP, SP, or DI in a string instruction are taken by default to 
be relative to DS. 

The contents of the SS register define the current stack segment. All data references 
which implicitly or explicitly involve SP or BP are taken by default to be relative 
toSS. 

The contents of the ES register define the current extra segment. The extra segment 
has no specific use, although it is usually treated as an additional data segment. 

The segment registers are illustrated below. 



15 



CS: 
DS: 
SS: 
ES: 



Segment Register File 



Status Registers 

The instruction pointer, flag register, CAUSE register, OPCODE register, PIP 
register, TIMER register, HTIMER register, BUFFERSIZE register, UPPER 
register, and LOWER register constitute the status register set. These registers pro- 
vide a variety of functions to the emulator. These registers are assigned the following 
mnemonics: 

IP: Instruction Pointer (8086) 
RF: Flag Register (ICE-86A emulator) 
CAUSE: CAUSE Register (ICE-86A emulator) 
OPCODE: OPCODE Register (ICE-86A emulator) 
PIP: Previous Instruction Register (ICE-86A emulator) 
TIMER: TIMER Register (ICE-86A emulator) 
HTIMER: HTIMER Register (ICE-86A emulator) 
BUFFERSIZE: BUFFERSIZE Register (ICE-86A emulator) 
UPPER: UPPER Register (ICE-86A emulator) 
LOWER: LOWER Register (ICE-86A emulator) 

The contents of the IP register define the offset to the CS register in instruction 
address computations. The Flag Register contains the status flag values in the same 
format as that pushed by the 8086 PUSHF instruction. The CAUSE register retains 
the cause of the last break in emulation and the OPCODE register stores the opcode 
fetched in the last instruction-fetch cycle in trace data. The Previous Instruction 
Register stores the displacement part of the address of the last instruction-fetch in 
trace data. TIMER contains the low-order 16 bits of the 2-MHz timer indicating 
how long emulation has run (read only). HTIMER contains the high-order 16 bits of 
the timer (read only). BUFFERSIZE contains the count (displayed in decimal only) 
of frames of valid trace data collected in the trace buffer (16 bit, read only). The 
UPPER register contains the highest address in ICE-86A workspace below the sym- 
bol table. The LOWER register contains the lowest address in ICE-86 workspace 
above the ICE-86A software. 
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The status registers are illustrated below. 



ip 

RF 
CAUSE 
OPCODE 
PIP: 
TIMER: 
HTIMER: 
BUFFERSIZE: 
UPPER: 
LOWER: 



Status Registers 



The Flag Register contains nine status bits. The following mnemonics are assigned 
to each of the status values in the register: 

AFL: Auxiliary carry out of low byte to high byte 

CFL: Carry or borrow out of high bit 

DFL: Direction of string manipulation instruction 

IFL: lnterrupt-enable (external) 

OFL: Overflow flag is signed arithmetic 

PFL: Parity 

SFL: Sign of the result of an operation 

TFL: Trap used to place processor in single step mode for debug 

ZFL: Zero indicates a zero value result of an instruction 



AFL is set if an instruction caused a carry out of bit 3 and into bit 4 of a resulting 
value. CFL is set if an instruction caused a carry or a borrow out of the high order 
bit. DFL controls the direction of the string manipulation instructions. IFL enables 
or disables external interrupts. OFL denotes an overflow condition in a signed 
arithmetic operation. SFL indicates the sign of the result of an operation. TFL 
places the processor in a single-step mode for program debugging. ZFL indicates a 
zero valued result of an instruction. The positions of the status bits in the RF 
Register are shown below. 





OFL 


DFL 


IFL 


TFL 


SFL 


ZFL 




AFL 




PFL 




CFL 



Flag Register 



The one byte CAUSE Register stores the cause for the last break in emulation. 

The byte returned by the "Read Break Cause" hardware command contains the 
following bit values (if bit = 1, then the specified condition is true, otherwise false). 
Each bit has associated with it a message that is displayed if the bit is true when the 
software command CAUSE is entered. 



Bit Position 


Condition 


Display 


0 


Breakpoint 0 matched 


'BRO' 


1 


Breakpoint 1 matched 


■BRV 


2 


Both breakpoints matched sequentially 


'SECT 


3 


Guarded memory access occurred 


'GUARD' 


4 


User aborted processing 


'ABORT' 


5 


Timeout on user READY 


'RDYTO' 


6 


Timeout on user HOLD 


'HLDTO' 


7 


External break signal 


'EXTRN' 
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BRO and BR1 occur when emulation is halted due to matching the condition set in 
the corresponding break register. Use of the breakpoint registers is discussed in 
Chapter 6. SEQ occurs when emulation is halted due to matching both breakpoint 
registers during the same instruction. For example, BRO can be set for the address of 
an instruction while BR1 is set for the value at that address, i.e., the instruction 
opcode. Then, when the specified instruction is fetched from the specified address, 
SEQ is the break condition displayed. GUARD occurs when memory that was NOT 
mapped is accessed. Memory mapping is discussed in Chapter 7. ABORT occurs 
when the user presses the escape key to halt emulation. RDYTO occurs when emula- 
tion is halted because of a ready timeout error. See Chapter 6 and Appendix B. 
HLDTO occurs when emulation is halted because of a hold timeout error. See 
Appendix B. EXTRN occurs when the user halts emulation through the external 
break line in the buffer box. See Chapter 1 for a description of this line. 

8086 Pin References 

The 1CE-86A emulator provides access to eight 8086 pins. The pin names reference 
1-bit values. Pin names are read-only references only. The following mnemonics are 
assigned to reference the 8086 processor pins shown below. 



Mnemonic 


8086 Pin 


Meaning 


RDY 


READY 


Acknowledgment from addressed memory or I/O 






device that it has completed data transfer. 


NMI 


NMI 


Non-maskable interrupt. 


TEST 


TEST 


Used by the wait-for-signal instruction for processor 






synchronization purposes. 


HOLD 


HOLD 


Request for local bus "hold". 


RST 


RESET 


Causes processor to immediately terminate present 






activity. 


MN 


MN/MX 


Specifies minimum/maximum configuration. 


IR 


INTR 


Maskable interrupt request. 


RQGT, BUS 


RQ/GTO, 


Request/Grant pin 




RQ/GT1 






(HOLD, HLDA) 





Emulation Registers 

The emulation registers consist of the breakpoint registers and the trace registers. 

Type Class Name Keywords 

Breakpoint register break-reg BRO, BR1,BR 

Trace point register trace-reg ONTRACE, 

OFFTRACE 

GO register go-reg GR 

The term break-reg is the class name for the two breakpoint registers used to halt 
emulation. The term trace-reg is the class name for the two registers that control 
tracing. The term go-reg refers to the GO-register, an 1CE-86A pseudo-register that 
controls the breaking of real-time emulation. 

Command Keywords 

The command keywords specify command types and command functions to be exe- 
cuted. 1CE-86A commands are of three major types: simple commands, compound 
commands, and macro commands. The following sections define the associated 
command formats and illustrate the use of keywords in each of the command types. 
Each of the formats is specified and illustrated by example using appropriate com- 
mand keywords. The full vocabulary of command keywords is presented following 
the command descriptions. 
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Simple Commands 

Simple commands are one of three types: 

• Set/change commands 

• Display commands 

• Execution commands 

The following sections describe the formats and provide examples of each of these 
simple commands. 



Set/Change Commands. The set/change commands have the following format: 

item-type [item-qualifier]... = new-setting 
where 

item-type A keyword or user name of an alterable element. 

item-qualifier A keyword, user name or value used to provide further 
specification of the particular element that is to be set or 
altered. 

new-setting The value that the specified item is to be set to. 

Examples: 

BR0 = 1000H EXECUTED 

BYTE 10FFH = 3AH 

..MOD1 .SYMBA .SYMBB = 10FFH 



Display Commands. The display commands have the following format: 

item-type [item-qualifier] . . . 
where 

item-type A keyword or user name of a displayable element or set 

of displayable elements. 

item-qualifier A keyword, user name or value used to provide further 

specification of the particular element(s) to be 
displayed. 

Examples: 
BRO 

BYTE 10FFH 

..MOD1. SYMBA. SYMBB 

REGISTER 

RAX 

FLAG 

STACK 10 
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Execution Commands. The execution commands have the following format: 



command-verb [command-parameter] . . . 
where 



command-verb A command keyword that describes an action that is 

to be performed. 

command-parameter Keywords that specify the objects of the action 

denoted by the command-verb. 

Examples: 



GO 

GO FROM .START 

GO FROM .START TILL 1000H EXECUTED 

TRACE 

PRINT ALL 

PRINT 10 

MOVE -10 



Compound Commands 

Complete description of the formats of the compound commands and the use of 
keywords with these commands is contained in Chapter 8. 



Macro Commands 

Complete description of the formats of the macro commands and the use of 
keywords with these commands is contained in Chapter 8. 



Utility Command Keywords 

The Intel Systems Implementation Supervisor (ISIS-II) is the diskette operating 
system for the Intellec Microcomputer Development System. The ICE-86A emulator 
runs under ISIS-II control, and can call upon ISIS-II for file management functions 
through the utility commands. These commands employ the following command 
keywords: 



Keyword 



Function 



ICE86 

EXIT 

LIST 

LOAD 

NOCODE 
NOLINE 

NOSYMBOL 

SAVE 

SELECTING 



Commands the ICE-86A program to load from diskette. 

Commands control to be returned to ISIS-II. 

Commands ICE-86A emulation output to be copied to printer or 

file. 

Commands user program to load into memory accessed by 
ICE-86A. 

A Modifier specifying that program code is not to be saved. 
A Modifier specifying that the line number table is not to be 
saved. 

A Modifier specifying that the symbol table is not to be saved to 
diskette. 

Commands user program to be saved on an external device. 
A Modifier specifying that a range of modules whose symbols 
are to be LOADed is to follow. 
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Number Base and Radix Commands 

ICE-86A commands and displays involve several different number bases (radixes). 
This section describes the command keywords and radixes used to control the 
number base. 



Keyword Function 

BASE Set or display console output radix. 

SUFFIX Set or display console input radix. 

EVALUATE Commands a numeric constant or expression to be displayed 

in all five possible output radixes. 

H Hexadecimal (base 16). 

0 Octal (base 8). 

Q Octal (base 8). 

T Decimal (base 10). 

Y Binary (base 2). 

ASCII ASCII character code. 



Memory Mapping Command Keywords 

These commands display, declare, set or reset the ICE-86A memory mapping. The 
ICE-86A emulator uses these maps to determine what memory is installed on a pro- 
totype system and what memory resources are being ' "borrowed" from the Intellec 
system and the ICE emulator for testing purposes. These commands employ the 
following keywords: 



Keyword 



Function 



DISK 

GUARDED 
ICE 

INTELLEC 
MAP 

NOVERIFY 

RESET 
USER 



Maps logical memory segments into a diskette file. 
Declares memory segments to be guarded. Accesses to 
addresses in these segments are error conditions. 
Maps memory segments into ICE "real-time" memory. 
Maps memory segments to expanded Intellec memory. 
Commands the ICE-86A emulator to display, declare, set, or 
reset ICE-86A memory mapping. 

Specifies that the normal read-after-write verification of data 

loaded into memory be suppressed. 

Resets the ICE-86A memory mapping. 

Maps logical segments into user's prototype memory. 



Hardware Register Command Keywords 

This section presents the keywords used in the ICE-86A emulator to specify and 
modify hardware register commands. 



Keyword 


Function 


BUS 


Command keyword indicating that the current master of the 




bus is to follow. 


CLOCK 


Command keyword indicating that a system clock specification 




is to follow. 


DISABLE 


Command keyword indicating that a command function is to be 




disabled. 


ENABLE 


Command keyword indicating that a command function is to be 




enabled. 


ERROR 


Command modifier specifying that an error is to be reported 




whenever the command signal times out. 


EXTERNAL 


ICE-86A is to operate from an external (user-provided) clock. 
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FLAG 

HARDWARE 
INFINITE 
INTERNAL 
PIN 

REGISTER 
RQGT 



RWTIMEOUT 



Contents of the 9 flags are to be displayed. 

Reset command modifier, causes a hardware reset. 

Set command signal timeout to "infinite," disabling timeout. 

ICE-86A is to operate from an internal (8086-provided) clock. 

Contents of the six 8086-input pins are to be displayed. 

Contents of the thirteen 16-bit 8086 registers and RF are to be 

displayed. 

Command keyword indicating that the methods of handling 
requests for the bus in maximum mode is to be displayed or 
set. 

Used to enable or disable memory access timeout. 



Memory and Port Contents Command Keywords 

These commands give access to the content or current value stored in designated 
memory locations or input/output ports. 



Keyword 


Function 


ABSOLUTE 


Display all addresses as 20-bit numbers. 


BASE 


Display all addresses in base and displacement format. 


BOOL 


Display expression as a boolean value. 


BYTE 


1-byte, unsigned integer value. 


INTEGER 


2-byte, unsigned integer value. 


LENGTH 


Indicates that an integer value denoting the length of a partition 




is to follow. 


DASM 


Indicates that a range of memory is to be disassembled into 




8086 assembly language mnemonics. 


DREAL 


8-byte, signed real value. 


POINTER 


4-byte, pointer value. 


PORT 


Reference to 8-bit I/O ports. 


REAL 


4-byte, signed real value. 


SINTEGER 


1-byte, signed integer value. 


STACK 


Indicates that words from the user's stack is to be displayed. 


TREAL 


10-byte, signed real value. 


WORD 


2-byte, unsigned integer value. 


WPORT 


Reference to 16-bit I/O ports. 



Symbol Table and Statement Number Table Command Keywords 

The ICE-86A emulator maintains a symbol table and source program statement 
number table to enable the user to refer to memory addresses and other values by 
using symbolic references and statement number references in ICE-86A commands. 
The following are command keywords contained in these commands: 



Keyword 


Function 


DEFINE 


Command keyword indicating a symbol is being defined. 


DISABLE 


Command keyword used to disable a facility. 


DOMAIN 


Keyword used to establish a default module for source 




statement number references. 


ENABLE 


Command keyword used to enable a facility. 


LINE 


Specifies the display of all of the source statement number 




table. 


MODULE 


Specifies the display of all of the ICE-86A module table. 


OF 


Specifies that a memory type designation is to follow. 


REMOVE 


Specifies that symbolic reference(s) is/are to be deleted. 


SYMBOL 


Specifies the display of the entire ICE-86A symbol table. 


SYMBOLICALLY 


Specifies the symbolic display of values. 


TYPE 


Indicates an assignment or change of memory type to a 




symbolic reference. 
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Emulation Control Command Keywords 

The emulation control commands permit the user to specify the starting address 
where emulation is to begin, and to specify and display the software or hardware 
conditions for halting emulation and returning control to the console for further 
commands. These commands employ the following keywords: 

Keyword Function 



ACKNOWLEDGE 


Match on 8086 intprnmt arknowlpdnp 


AND 


Indicates a match on both breakpoint registers required to halt 




emulation 

wll IUIUUvI I* 


DOWN 


Less than or equal to the referenced address. 


EXECUTED 


An instruction fetch out of the execution queue. 


FOREVER 


All break conditions disabled. 


FETCHED 


Memory read into the execution queue. 


FROM 


Keyword introducing a starting address. 


GO 


Command keyword that starts emulation. 


HALT 


8086 processor halt. 


INPUT 


I/O port read. 


LOCATION 


Denotes the following constant or expression to be an 




address. 


OR 


Indicates that a match on either breakpoint register will halt 




emulation. 


OBJECT 


Indicates that a memory reference or typed memory reference 




is to follow. 


OUTPUT 


I/O port write. 


READ 


Memory read. 


STEP 


Single-step emulation command. 


TILL 


A keyword introducing one or more match or halt conditions. 


UP 


Greater than or equal to the referenced address. 


USING 


Indicates that a segment register is to be specified. 


VALUE 


Denotes the following constant or expression to be a data 




value. 


WRITTEN 


Memory write. 



Trace Control Commands 

The trace control commands allow the user to display or change the match condition 
in either or both of two tracepoint registers and to establish a tracepoint to condi- 
tionally start trace collection and a tracepoint to stop collection. These commands 
employ the following keywords: 



Keyword 


Function 


ADDR 


Low-order 16 address/data bits. 


ALL 


A function keyword indicating that the entire trace buffer 




contents are to be displayed. 


BHE 


Byte High Enable. 


CONDITIONALLY 


Indicates trace is to be turned on when ONTRACE matches and 




turned off when OFFTRACE matches. 


DMUX 


Type of frame. 


EXTRADDR 


High-order 4 address bits (address frame) or 4 status bits (data 




frame). 


FRAME 


Indicates that a trace reference is to follow or that the trace 




buffer is to be displayed frame by frame. 


INSTRUCTION 


A function keyword indicating that data in the trace buffer is to 




be displayed in instruction format. 


MARK 


Equal 1 if trace was turned off before current frame or if 




emulation broke before current frame. 
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QDEPTH 
QSTS 
STS 
TRACE 



MOVE 
NEWEST 
NOW 
OFF 

OLDEST 
ON 

PRINT 



Command keyword moves the trace buffer pointer. 
Moves trace buffer pointer to bottom of buffer. 
Indicates trace setting for beginning of next emulation. 
Indicates trace turned off. 
Moves trace buffer pointer to top of buffer. 
Indicates trace turned on. 

Command keyword calling for a display of one or more entries 
from the trace data buffer. 
Queue depth. 

2 queue status bits, QS1 , QSO. 

3 status bits S2/,S1/,S0/. 

Command keyword indicating that the mode of display for trace 
data is to be set. 



User Names 



The command language permits the programmer and operator to employ symbolic 
addressing through the use of user-generated tokens as opposed to system-generated 
tokens (keywords). The language permits four types of user names: symbols, 
module names, statement numbers and macro names (see Chapter 8). 



Symbols 

A symbol is a sequence of contiguous alphanumeric characters, prefixed by a period 
(.), that references a location in a symbol table. The symbol has two uses. The 
referenced table location always contains a number; it may be an address of an 
instruction or variable in a program module, or it may be used directly as a 
numerical value. In the first case, the symbol is an alternative method of program 
addressing (symbolic as opposed to direct numeric addresses). In the second case, it 
provides a method for storing and retrieving data values symbolically into/from the 
table itself. 



As an example, consider the symbol .BEGIN in module ..MAINLOOP. The entire 
reference to this occurrence of .BEGIN is: 

..MAINLOOP. BEGIN 



the double period (..) designates MAINLOOP as a. module-name and 
the single period (.) designates BEGIN as a symbol-name. 



Statement Numbers 

In the process of compiling a source module in DEBUG mode, the PL/M compiler 
generates a set of (source) statement numbers, one for each source statement in the 
module. Each statement number is linked to the absolute address of the first 
instruction generated by the PL/M compiler for the associated source statement in 
the source program. Each compiled program will contain a table of statement 
numbers and absolute addresses. Items (addresses) in the table are referenced by 
entering the associated statement number. 



where 
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The form of reference is: 

module-name # decimal- 10 
where 

# is the 'number' sign; this designates the reference as a statement number and 

decimal-10 is the (source) statement number (a numeric constant). The default 
suffix of decimal-10 is always decimal. 

For example, 

..MAINLOOP#123 

#123 is statement number 123 in the source program ..MAINLOOP. This reference 
would obtain the address of the first instruction generated by source statement 123 
of module. .MAINLOOP. 

Statement numbers are an alternative to program addressing, as opposed to labels in 
the program. 



Special Tokens 



The command language contains two special token sets that provide special func- 
tions: operators and punctuation. 



Operators 

Type 

relational 
plus 
mult 
logical 



Class Name 

rel-op 
plus-op 
multi-op 
log-op 



Operators 

=,<,>, <=, < >, >= 

+ , -, (binary and unary) 

*, /, MOD 

NOT, AND,OR,XOR 



Punctuation 
Type 

punctuation 



Class Name 

punct-op 



Punctuation Characters 

'&.,;: !)($CRLFSP%#.. ! 



The use of punctuation characters are defined in those sections that define command 
formats. 



Entering Commands at the Console 

The 1CE-86A emulator displays an asterisk prompt (*) at the left margin when it is 
ready to accept a command from the console. 

Each command is entered as a command line, which consists of one or more input 
lines; the length of an input line is limited to the number of characters that one line 
of the console display can contain. 
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The ICE-86A emulator recognizes the carriage return as the terminator for a com- 
mand line. If it is necessary to use more than one input line to enter a command, 
each intermediate input line should end with an ampersand (&). When the ICE-86A 
emulator encounters the ampersand, it suppresses the interpretation of the com- 
mand that would occur on encountering the carriage return that follows. After the 
carriage return is executed, the ICE-86A emulator displays a double asterisk prompt 
(**) to acknowledge the continuation of the command line. 

Tokens in the command are separated by blanks, unless the construct requires 
another form of separator. For example, tokens in a list are separated by commas; 
in this case, blanks (spaces) may be inserted for clarity but are not required. 

Any input line may include comments. The comments which are preceded by a 
semicolon (;) must appear after any portion of the command that is on that input 
line; in other words, if the first character in an input line is a semicolon (;), the entire 
input line must consist of comments. Characters in a comment are not interpreted by 
the ICE-86A emulator and are not stored internally except in a DEFINE MACRO 
command. The main use of comments is to document an emulation session while it 
is in progress. 

Comments may not be continued from input line to input line. If an ampersand is 
used to continue a command line that also contains comments, the ampersand must 
come before the comment. An ampersand that is embedded in a comment is ignored 
by the ICE-86A emulator. 

You can use ISIS-II editing capabilities to correct errors in the current input line. 
The line-editing characters are as follows: 

Characters Result 

RUBOUT Delete last character entered in input line. The deleted 

character is echoed immediately. The RUBOUT func- 
tion can be repeated, deleting one character each time it 
is pressed. 

CTRL X Delete entire input line. (CRTL Z gives the same result.) 

CTRL R Display entire input line as entered so far. This is useful 

after a RUBOUT, to review which characters have been 
deleted. 

ESC Cancel entire command being entered. 

CRTL P Input next character literally. 

Carriage Return Terminate input line or command line. 

Line Feed Terminate input line 

Once a line terminator (carriage return or line feed) has been entered, that line can 
no longer be edited. 

The dollar sign ($) is ignored by the ICE-86A emulator in identifiers. You can use it 
as a separator when you want to combine two words into one token. For example, 
suppose you wanted to combine the two system groups DATA and STS into one 
symbol for your use. Instead of DATAANDSTS, you can use the $ character as a 
separator: DATA$AND$STS. 
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An expression is a formula that evaluates to a number. The formula can contain 
operands, operators, and parentheses. Expressions and operands appear in the 
ICE-86A emulator as command arguments to specify numeric values or boolean 
conditions. Depending on the command context, the resulting number is interpreted 
either as a numeric value or as a logical state (TRUE/FALSE). All expressions and 
operands represent one of the following: 

• Pointer: a pair of 16-bit unsigned integers. One integer is called the base (b) and 

the other integer is called the displacement (d). This manual uses the 
notation b:d to denote a pointer with a base b and displacement d. 
The operator is a base-displacement integer connector (see table 
5-3). Pointers may be used as memory addresses; then the 20-bit 
absolute address is 16*f> + d. 

• Integer: a single 16-bit unsigned integer treated modulo 65536. This is a special 

case of a pointer, with the base value equal to 0. 

The ICE-86A emulator provides only unsigned-integer arithmetic on pointers and 
integers. The arithmetic operations are always applied separately to bases and 
displacements (i.e., integer arithmetic is always 16-bit and is always done on the 'd' 
portion of 'b:d' address). Signed arithmetic is not provided. There are no arithmetic 
operators for REAL, TREAL, or DREAL types. REAL, DREAL, and TREAL 
cannot be EVALuated. 

A few examples are all that is necessary to illustrate the concept of expressions. 

1. The simplest form of an expression is a single value. That is, an expression that 
contains only one operand and no operators or parentheses: 

3 

FFFFH 
127Q 

2. The following expressions contain both operands and operators: 

2 + 3 

1001110011101111Y - 101 Y 

127/44 

0100:00FFH 

3. The following expressions contain operands, operators and parentheses: 

2 * (6 + 4) 
(127 + 44)/ 20 

4. The use of symbols to reference numeric values represents a significant 
capability of the ICE-86A emulator. The following examples illustrate the use 
of symbols in expressions: 

.SYMBA OR .SYMBC 

(!VAR1 + 10)/(!VAR2-.SYMBD) 

This introduction to expressions is sufficient for the first reading of this manual or if 
the reader has familiarity with previous ICE products. Therefore, you may skip the 
remainder of this chapter and read the remaining chapters using the examples to 
gain further familiarity with the use of expressions in ICE-86A commands. The 
remainder of this chapter describes how expressions are constructed by representing 
the types of operands and operators that can be used, and provides the rules and 
some examples to explain how expressions are evaluated. The chapter also describes 
numeric and logical (boolean) command contexts, and gives a condensed syntax 
summary for expressions. 
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Operands 

All operands are composed of either pointers or unsigned integers. Operands can be 
specified by any of the following references: 

• numeric constant 

• masked constant 

• keyword reference 

• symbolic reference 

• statement number reference 

• memory reference 

• typed memory reference 

• port reference 

• string 

• (expression) 

The following paragraphs define and explain each of the above operand types and 
formats. 



Numeric Constants 



A numeric constant produces a 16-bit integer value and is specified by a sequence 
composed of decimal digits and the letters "A" through "F" (hexadecimal digits), 
and, optionally, a suffix to specify explicitly the constant's radix: 

numeric-constant = digit . . . [suffix] 

Where: 

digit = 0::1 ::2::3::4::5::6::7::8::9::A::B::C::D::E::F 
And: 

suffix = H::T'.:0:\Q:\Y 

In the absence of a suffix, the default input radix for the current context is used. In 
most cases this is the radix set by the SUFFIX command; however, some commands 
may default their parameters to other radices. The allowed radices and their suffixes 
are: hexadecimal ("H"), decimal ("T"), octal ("O" or "Q"), and binary ("Y"). 
The radix determines which characters are valid in the constant. Numeric constants 
represent fixed unsigned integer values. The elements of numeric constants are sum- 
marized in table 5-1. 

Examples: 

100111101 01 00111Y 

1234 

1974T 

A2EH 

177Q 
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Table 5-1 . Elements of Numeric Constants 



Miimhpr Race 


Valid Dinits 


Pyrvlicit Rarity 




Binary (base 2) 


0,1 


Y 


11001110101101 01Y 


Octal (base 8) 


0-7 


Q,0 


4726Q 


Decimal (base 10) 


0-9 


T 


397T 


Hexadecimal (base 16) 


0-9, A-F 


H 


00FE3H 


(multiple of 1024) 


0-9 




64 



A numeric constant entered through the console with an explicit radix is interpreted 
accordingly. If it contains any digits that are invalid for that radix, an error results. 

A numeric constant entered from the console without an explicit radix is interpreted 
according to the implicit radix that applies to the context. In most contexts, the 
implicit radix is initially hexadecimal (H); in these contexts, the implicit radix can be 
set to Y, Q, O, T or H by using the SUFFIX command. 



Masked Constants 

A masked constant is syntactically identical to a numeric constant except it may not 
contain the "T" suffix and must contain one or more "X" characters. Each "X" 
character represents a 'don't care' digit (1, 3, or 4 bits depending upon whether the 
radix is binary, octal, or hexadecimal). The radix, either explicit or implicit (i.e., 
previously specified), must be binary, octal or hexadecimal. The following are 
examples of masked constants : 

10X1X01Y (binary - 2 don't care bits shown explicitly) 

3X4Q (octal - 3 don't care bits implicit because each octal 

numeral represents 3 bits; equivalent to 01 1XXX100Y) 

6FX1H (hexadecimal - 4 don't care bits, implicit because each 

hexadecimal numeral represents 4 bits; equivalent to 
01101111XXXX0001Y) 



Keyword References 

Keyword references are used to gain access to all of the system variables, including 
registers, status flags, input pins, and status information. When one is used in a 
command, the value returned is a 16-bit integer and is the current contents of the 
referenced object. Thus indirection through referenced variables is obtained. The 
values of system variables may be used in boolean conditions in control structures. 
A keyword reference may reference a value less than 16 bits. If the keyword 
reference returns a value of less than 16 bits, the value is coerced to 16 bits by right- 
justifying it and filling the high-order bits with zeroes. (Refer to Chapter 4 for a 
listing and description of reference keywords.) 



Examples: 



SP = SP - 2 (decrement the contents of the Stack Pointer) 

RAX (display the contents of the Accumulator) 

TIMER (display the contents of the TIMER register) 

AFLOR OFL ("OR" Auxiliary-carry and Overflow flags) 
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Symbolic References 

A symbolic reference points to an entry in the ICE-86A symbol table. Correspond- 
ing to each symbol table entry is a pointer value that represents an address or a con- 
stant. .When a symbol reference is entered as an operand, its corresponding value is 
obtained from the referenced table location and used in the associated expression. A 
symbolic reference is specified in the following format: 

symbolic-ref = [module-ref] symbol ... 

Module references and symbols are both user-assigned. Module names are LOADed 
with a program— they cannot be assigned from the ICE-86A emulator. Most sym- 
bols are also LOADed. The module name identifies a particular symbol table that 
contains the symbols associated with a particular program module. The symbol 
table contains the symbols that are used by that program. Module names and sym- 
bols are composed of user names and identifying prefixes. User names are composed 
of character strings where each character may be an alphabetic character, digit, 
"@," underscore (_), dollar sign ($), or "?" with the exception that the first 
character in the string may not be a digit. The module name is prefixed by a double 
period (".."): 

module-ref = . .module-name 
A symbol is identified by a single period prefix ("."): 

symbol = .symbol-name 
Therefore the format for a symbolic reference can be shown as follows: 

symbolic-ref = [..module-name] .symbol-name... 

If a module name is present, then only the referenced module's symbol table is 
searched; otherwise all of the current symbol table is scanned for the referenced 
symbol. If more that one symbol is referenced, the symbol table is scanned for the 
occurrence of the first symbol in the list. Then the table is scanned for the first 
occurrence of the second symbol following the entry for the first symbol. This is 
repeated in sequence for all the symbols in the list. The value returned is the pointer 
containing the base and displacement address values for the entry specified by the 
symbolic reference. 

The use of the symbol table provides you with considerable freedom in referencing 
and retrieving user variables. The ability to assign symbolic names to variables, pro- 
cedures, and module names allows you to assign them names that can be associated 
with their functions and interrelations within the program. For example, assume 
that the symbol .X represents a variable that is used in procedures PROCX, 
PROCY, and PROCZ of module MODABLE. Then the value of variable X in 
PROCY can be retrieved with the following symbolic reference: 

..MODABLE. PROCY. X 

whereas the value of variable X in PROCZ is obtained by: 

..MODABLE.PROCZ.X 

Statement Number Reference 

A statement number reference points to the address of the first instruction generated 
by the compiler for the source statement specified by the associated statement 
number. Statement number information for each compiled program module is 



5-4 



ICE-86A 



Expressions 



stored in its statement number table. Therefore program locations can be referenced 
symbolically via statement number. The LINK process can combine different 
modules, each with its own set of statement numbers. Therefore, a statement 
number reference may require a module reference in the same format as that used in 
a symbolic reference. A statement number reference uses the following format: 



source-statement-ref = [..module-name ] # statement-number 



The statement number is an integer value that specifies the number of the source 
statement. If the statement number does not have an explicit suffix, the default 
suffix is decimal. If more than one program module is currently loaded into 
ICE-86A memory, a module reference is required to distinguish the reference from 
identical reference numbers in other modules. Examples are: 



#45 

..TEST1 #12FH 



The value returned is a pointer value that is the absolute address of the first instruc- 
tion generated by the compiler for the source statement referenced by the statement 
number. 

Memory References 

References to memory specify the type of reference as well as the memory location 
(address) required. A memory reference uses the following format: 

memory-ref=reference-type address 



reference-type Definition 

BYTE 1-byte integer value at location "address". 

WORD 2-byte integer value with low byte at "address" and high byte at 
"address" + 1. 

SINTEGER Same as BYTE. 

INTEGER Same as WORD. 

POINTER 4-byte pointer value located at "address" through "address" + 3. 

REAL 4-byte real value located at "address" through "address" + 3. 

DREAL 8-byte real value located at "address" through "address" + 7. 

TREAL 10-byte real value located at "address" through "address" + 9. 



When changing memory or referencing it in an expression, BYTE is equivalent to 
SINTEGER and WORD to INTEGER. However, when displaying memory, the 
format of the display is either unsigned (BYTE, WORD) or signed (SINTEGER, 
INTEGER, REAL, DREAL, TREAL). (See Display Memory command, 
Chapter 7.) 

Examples: 

BYTE 1000H 
BYT0100:0000H 
WORD 101 
INTEGER .ABLE 
POINTER CS:IP 
REAL 011 0:1 000H 
REAL1000H 
DREAL 1000 LEN4 
TREAL 100:10 
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Typed Memory Reference 

A typed memory reference employs the symbols contained in the ICE-86A symbol 
table tp obtain both location and type of memory reference. Each symbol has one of 
the following types of memory references or has no type: 



BYTE 

WORD 

SINTEGER 

INTEGER 

POINTER 

REAL 

DREAL 

TREAL 



1- byte integer value 

2- byte integer value 
Same as BYTE 
Same as WORD 
4-byte pointer value 
4-byte real value 
8-byte real value 
10-byte real value 



If a symbol has a memory reference type, the symbol represents a memory reference. 
If the symbol has no memory reference type, the symbol represents a label, pro- 
cedure name, or a constant. If the source language translator generates type 
information in the object file, then the type values are loaded with the symbols in the 
ICE-86A emulator. The user may also specify memory reference type when defining 
symbols or when using the ICE-86A TYPE command. 

A typed memory reference is executed with the following format: 

typed-mem-ref s [Wmodule-name ] \symbol-name ... 

Example: 

Assume module table ..SAM contains: 



Symbol 


Type 


Base Value 


Displacement Value 


.X 


BYTE 


100H 


0 


.Y 


WORD 


100H 


0 


.Z 


POINTER 


100H 


0 


.R 


REAL 


100H 


0 


.D 


DREAL 


100H 


0 


.T 


TREAL 


100H 


0 



Also assume: 



Memory Location 

1000H 
1001H 
1002H 
1003H 
1004H 
1005H 
1006H 
1007H 
1008H 
1009H 



Content 

21 
43 
65 
87 
54 
32 
12 
89 
75 
47 



Therefore: 



!!SAM !X = 21 
!!SAM !Y = 4321 
!!SAM !Z = 8765:4321 
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!!SAM!R = 1.72477726E-34 

MSAM !D = 5.64331 2861 5079697E-265 

!!SAM !T = 9.931 791 29344306291 E + 574 



Port References 

The 1CE-86A emulator supports a maximum of 64K 8-bit or 32K 16-bit I/O ports. 
These ports are referenced in the following format: 

port-ref =PORT address : ".WPORT address 

PORT references an 8-bit I/O port at location ' 'address". WPORT references a 
16-bit I/O port at location "address". The value of "address" must be an integer. 
The port is read or written immediately when referenced. 

Examples: 

PORT 123 
PORT RDX 
WPORT 1FFH 



String Constants 

Any one of the ASCII characters (ASCII codes 00H through 7FH) can be entered as 
a string constant by enclosing the character in single quotes. The operand value of a 
string constant is a 16-bit integer with the high-order bits set to 0, and the 7-bit 
ASCII code in the low-order seven bits. For example, the string constant 'A' has the 
value 0000000001000001 Y (0041H). 

In data communications usage, an ASCII-coded character consists of seven low- 
order data bits (bits 0-6), and a parity bit (bit 7). Thus another way to describe the 
operand value of an ASCII string constant is as a two-byte integer; the high byte is 
all zeros and the low byte contains the 8-bit ASCII value with the parity bit set to 0. 

Table 5-2 gives the printing ASCII characters with their corresponding hexadecimal 
codes (codes 20H through 7EH). Note that some console keyboards output upper 
case ASCII characters only, or lack keys for some of the non-printing ASCII codes. 

Parenthesized Expressions 

(exp): an operand whose value is the value of the parenthesized expression, e.g., 
(1+2+3) = 6 (operand value). 



Operators 

An expression can contain any combination of unary and binary operators. Table 
5-3 describes all the operators available under the ICE-86A emulator. The operators 
are ranked in order of precedence from highest (1) to lowest (10). Other things being 
equal, the operator with the highest precedence is evaluated first. The operators are 
shown in the table as they are to be entered in expressions. The class content- 
operators has too many details to fit the table; see table 5-5. The table identifies each 
operator as unary or binary. A unary operator takes one operand, and a binary 
operator takes two operands. 
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Table 5-2. ASCII Printing Characters and CODES (20H — 7EH) 



Character 


Hex Code 


Character 


Hex Code 


Character 


Hex Code 


Space (SP) 


20 


@ 


40 




60 


I i 


21 


A 


41 


a 


61 




22 


B 


42 


b 


62 


# 


23 


C 


43 


c 


63 


$ 


24 


D 


44 


d 


64 


% 


25 


E 


45 


e 


65 


& 


26 


F 


46 


f 


66 




27 


G 


47 


9 


67 


< 


28 


H 


48 


h 


68 


> 


29 


I 


49 


i 


69 


★ 


2A 


J 


4A 


j 


6A 


+ 


2B 


K 


4B 


k 


6B 


> 


2C 


L 


4C 


I 


6C 


— 


2D 


M 


4D 


m 


6D 




2E 


N 


4E 


n 


6E 


/ 


2F 


0 


4F 


0 


6F 


0 


30 


P 


50 


P 


70 


1 


31 


Q 


10 


q 


71 


2 


32 


R 


52 


r 


72 


3 


33 


S 


53 


s 


73 


4 


34 


T 


54 


t 


74 


5 


35 


U 


55 


u 


75 


6 


36 


V 


56 


V 


76 


7 


37 


w 


57 


w 


77 


8 


38 


X 


58 


X 


78 


9 


39 


Y 


59 


y 


79 




3A 


z 


5A 


z 


7A 


> 


3B 


] 


5B 




7B 


< 


3C 


/ 


5C 


I 


7C 




3D 


[ 


5D 




7D 


> 


3E 


A(t) 


5E 




7E 


? 


3F 




5F 







Classes of Operators 

For discussion, the operators are classed as shown in table 5-4. Table 5-6 specifies 
the arithmetic and logical semantic rules for operators. 



Arithmetic Operators 

The ICE scanner distinguishes unary and from binary and by 
context. Unary is superfluous, since it is a no-operation. 

A unary applied to an integer means "2's complement modulo 65536". In 
other words, (-N) evaluates to (65536 - N). As the ICE-86A emulator uses only 
unsigned arithmetic, unary does not apply to pointers. The unary is also 
used in the MOVE and PRINT commands (see MOVE and PRINT commands in 
Chapter 6). 

Binary applies to pointer and integer values only and results in the arithmetic 
sum of its two operands. In the case of the sum of two integers, the result is treated 
modulo 65536 (any high-order bits after the sixteenth bit are dropped). In the case of 
the sum of a pointer and an integer, the displacement value of the pointer is summed 
with the integer modulo 65536 and the base value of the pointer is unchanged. 

Binary applies to pointer and integer values only and results in the arithmetic 
difference of the two operands. In the case of the difference of two integers, the 
result is the 2's complement difference of the two integers; this result is also treated 
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modulo 65536, so that a "negative" result (-N) ends up as (65536 - N). An integer 
may also be subtracted from a pointer. In this case, the result is the 2's complement 
difference of the pointer displacement and the integer modulo 65536 and the base 
value of the pointer remains unchanged. The can be used to obtain the 
arithmetic difference of two pointers but only if they have the same base value. In 
this case the result is the 2's complement difference of the displacements modulo 
65536 and the resulting base value is set equal to zero. An error occurs if the base 
values of the pointers are not equal. 

The operators "*", "/", "MOD", and "MASK" can be applied only to integer 
operands and return only integer results. 

Binary "*" results in the multiplication of two integer operands, truncated to the 
low-order 16 bits. 

Binary 4 7" causes the first integer operand to be divided by the second. The result is 
the integer quotient; the remainder, if any, is lost. Thus, (5/3) evaluates to (1). 

Binary "MOD" returns the remainder after integer division as an integer result, and 
the quotient part of the division is lost. Thus, (5 MOD 3) evaluates to (2), the 
remainder of (5/3). 

Binary "MASK" performs a bitwise logical AND on two integer operands. If both 
are l's, the result has 1 in that bit; otherwise the result has 0 in that bit. MASK is 
identical to the boolean "AND" operator, except that MASK has higher 
precedence. 

:, SEGMENT, OFFSET have the highest precedence of the arithmetic operators. 
Binary "*", "/", and "MOD" have equal precedence, lower than unary "-". 
Binary "+" and "-" have equal precedence, lower than "*", "/", and "MOD". 
"MASK" has lowest precedence of the arithmetic operators (see table 5-3). 



Table 5-3. ICE™ Operators 



Precedence 1 


Operator 


Unary 
Binary 2 


Effect 3 


1 




u 


Base, displacement integer connector for a pointer 
(e.g., 1234:5678 or CS:IP). 




OFFSET 


u 


Designates integer value that is the displacement of a 
pointer (e.g., OFFSET 1234:5678 is 5678). 




SEGMENT 


u 


Designates integer value that is the base of a pointer 
(e.g., SEGMENT 1234:5678 is 1234). 


2 


+ 


u 
u 


Unary plus. 

Unary minus, (-N) means (65536-N), the 2's 
complement of N, modulo 2 16 


3 


★ 


b 


Integer multiplication. 




/ 


b 


Integer division. The result is the integer quotient; 
the remainder (if any) is lost. 




MOD 


b 


Modulo reduction. The remainder after division, 
expressed as an integer. 


4 


+ 

i 


b 
b 


Addition. 
Subtraction. 


5 


MASK 


b 


Bitwise AND. Higher precedence than identical 
operation AND (see below). 


6 


content- 
operator 4 


u 


Treats operand as memory or port address, returns 
the content of that address. 
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Table 5-3. ICE™ Operators (Cont'd.) 



Precedence 1 


Ooerator 


Unary 
Binary 2 


Effect 3 


7 


= 


b 


Is equal to. Result is either TRUE (FFFFH) or FALSE 

(0). 




> 


b 


Is greater than. Result is TRUE or FALSE. 




< 


b 


Is less than. Result is TRUE or FALSE. 




< > 


b 


Is not equal to. Result is TRUE or FALSE. 




>= 


b 


Is greater than or equal to. Result is TRUE or FALSE. 






h 


|c loQc than nr omial tn RoQiilt ic TRI IP r»r FAI 

lo ICoo 11 IdM VJI tiLjUdl IU. ncoUll lo 1 nut Ul InLOL. 


8 


NOT 


U 


Unary Logical (1's) complement. Bitwise 1 becomes 
0, 0 becomes 1; TRUE becomes FALSE, FALSE 
becomes TRUE. 


9 


AND 


b 


Bitwise AND. If both corresponding bits are 1's, 
result has 1 in that bit; else 0. TRUE AND TRUE yields 
a TRUE result; any other combination is FALSE. 


10 


OR 


b 


Bitwise inclusive OR. If either corresponding bit is a 
1, result has 1 in that bit; else 0. If either operand is 
TRUE, result is TRUE; else FALSE. 




XOR 


b 


Bitwise exclusive OR. If corresponding bits are 
different, result has 1 in that bit; else 0. If one operand 
is TRUE and the other is FALSE, result is TRUE; if 
both are TRUE or both are FALSE, result is FALSE. 



NOTES: 



1 1 = highest precedence (evaluated first), 10 = lowest precedence. 

2 u = unary, b = binary. 

3 Refer to text for additional details. 

4 content-operator is one of the tokens BYTE, WORD, SINTEGER, INTEGER, POINTER, 
REAL, PORT, or WPORT. 



Table 5-4. Classes of Operators 



Class 


Operators 


(Numeric) 




Arithmetic 




unary 


+, -., SEGMENT OFFSET, 


binary 


■*,./, MOD, +, - MASK, : 


Content 




unary 


content-operators 


(Boolean) 




Relational 




binary 


= >, <, <>, >= <= 


Logical 




unary 


NOT 


binary 


AND, OR, XOR 


Unary 


+,-, SEGMENT, OFFSET, 




content-operators , 




NOT 


Binary 


*,/, MOD, +,-, MASK, :, 




relational-operators , 




AND, OR, XOR i 



5-10 



ICE-86A 



Expressions 



Content Operators 

Content operators are keywords that refer to the contents of memory locations and 
I/O ports. In expressions, they function as unary operators with precedence 
immediately below "MASK". Table 5-5 summarizes the content operators for 
the ICE-86A emulator. 



Table 5-5. Content Operators 


Operator 


Content Returned 


BYTE 


1-byte integer value from the addressed location in memory. 


WORD 


2-byte integer value from the addressed location in memory. 


SINTEGER 


Same as BYTE. 


INTEGER 


Same as WORD. 


POINTER 


4-byte pointer value from the addressed location in memory. 


PORT 


1-byte value from addressed 8-bit I/O port. 


WPORT 


2-byte value from addressed 16-bit I/O port. 


REAL 


4-byte floating point number from the addressed location in memory. 


DREAL 


8-byte floating point number from the addressed location in memory. 


TREAL 


10-byte floating point number from the addressed location in 
memory. 



To be used in an expression, a content operator must precede a single operand that 
can be interpreted as a valid address. A partition of addresses (using a keyword such 
as TO or LENGTH) cannot be used in an expression. Furthermore, the address 
given must be accessible (not GUARDED) if it uses the memory map (see MAP 
commands in Chapter 7). 



Relational Operators 

A relational operator calls for a comparison of the values of its two operands. The 
six possible relational operations are shown in table 5-4. Each comparison is either 
true when the expression is evaluated, or it is false. The result is correspondingly 
TRUE (FFFFH) or FALSE (0). 



Logical Operators 

The "NOT" logical operator results in a l's complement of an operand; a 16-bit 
operand is assumed. The following are examples of "NOT" logical operations: 



Operand Operation Result 

0 NOT FFFFH 

1 NOT FFFEH 
11110110Y NOT 1111111100001001Y 

FFFFH NOT 0 

FFFEH NOT 1 
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ANDing two operands results in the following values depending upon bit pair 
values: 



bit 1 


bit 2 


Result 


0 


0 


0 


0 


1 


0 


1 


0 


0 


1 


1 


1 



Examples: 



Logical Operation Result 

0 AND 0 0 
1010Y AND 1001 Y 1000Y 
FFFFH AND 0 0 
FFFFH AND FFFFH FFFFH 

1 AND 0 0 



ORing two operands results in the following values depending upon bit pair values: 
bit 1 bit 2 Result 

0 0 0 

0 11 

1 0 1 

1 1 1 

Examples: 



Logical Operation Result 

0OR0 0 
1 0R0 1 

1010YOR1001Y 1011Y 

FFFFH OR 0 FFFFH 

FFFFH OR FFFFH FFFFH 



The result of an "XOR" operation is as follows: 

bit 1 bit 2 Result 

0 0 0 

0 1 1 

1 0 1 
1 1 0 

Examples: 



Logical Operation Result 

0XOR0 0 
1 XOR 0 1 
1010YXOR1001Y 11 Y 

FFFFH XOR 0 FFFFH 
FFFFH XOR FFFFH 0 
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Arithmetic and Logical Semantic Rules 

Table 5-6 provides a summary of the semantic rules that apply to arithmetic and 
logical operations. The table specifies the function performed by each type of 
arithmetic and logical operation, the input required, and the result of the operation 
(output). 



Table 5-6. Arithmetic and Logical Semantic Rules 



Operation 


Operators 


Input 


Output 


Function 


logical 


AND, OR, XOR, MASK 


2 integers 


integer 


Bitwise conjunction or disjunction of integers. 


not 


NOT 


integer 


integer 


One'scomplementof an integer. 


relational 


<, >,<=>=<>,= 


(1) 2 pointers, same 
base 

(2) 2 integers 


integer 
integer 


Logical test of relational expression. If the displace- 
ment integer values satisfy relational operation (true), 
then the output integer value = FFFFH. If the displace- 
ment integer values do not satisfy the realtional opera- 
tion (false), the output integer = 0. If the base values of 
the input pointers are not equal, an error occurs. 


arithmetic 


\/,M0D 


2 integers 


integer 


Unsigned product (*), quotient^), or remainder(MOD) 
of two integers. 


memory- 
content 


BYTE, WORD, INTEGER, 
SINTEGER 


pointer or 
integer 


integer 


Fetches content of memory location addressed by 
input value. 


memory- 
content 


POINTER 


pointer or 
integer 


pointer 


Fetches content of memory location addressed by 
input value. 


1/0- 
content 


PORT.WPORT 


integer 


integer 


Fetches content of I/O port (8-bit or 16-bit) addressed 
byinputvalue. 


+(binary) 


+ 


(1) pointer, integer 

(2) integer, integer 


pointer 
integer 


Sum of the displacement values, same base as the 
pointer. Sum of the integers. 


-(binary) 




(1) 2 pointers with 
= base values 

(2) pointer & 
integer 


integer 
pointer 


Two's complement difference of displacement values. 
Error occurs if base values are unequal. 
Two's complement difference of pointer displacement 
value and integer input, same base as the pointer. 


-(unary) 




integer 


integer 


Two's complement of the input integer. 


+(unary) 


+ 


All types 


same 


No change. 

• 


override 
base/ 
construct 
pointer 

offset 


OFFSET 


(1) integer& pointer 

(2) 2 integers 

pointer 


pointer 
pointer 

integer 


Replaces current base value of pointer with input 
integervalue. 

Constructs new pointer with base value set to first 
input integer value and displacement set to second 
integer. 

Generates integer value whose value is the displace- 
ment value of the input pointer. 


segment 


SEGMENT 


pointer 


integer 


Generates integer whose value is the base value of the 
input pointer. 
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How Expressions are Evaluated 

This section provides a simple conceptual model of how the ICE-86A emulator 
evaluates an expression. The model involves a loop that scans the expression 
iteratively (figure 5-1). The loop terminates in either of two ways: 

crtblthe expression resolves to a single numeric value. 

• When a syntax error (or other error) occurs. 

The ICE-86A emulator goes through the scan loop once for each operator in the 
expression. On each scan, the operator (unary or binary) that must be applied next is 
identified. 

The next operator is always: 

• the leftmost operator 

• with highest precedence (table 5-3) 

• that is enclosed in the innermost pair of parentheses. 

If this next operator is unary and has a numeric operand, the operation is performed 
on the operand to produce a numeric result. If the next operator is binary and has a 
pair of operands, the operation is performed on the pair of operands to produce a 
numeric result. If the next operator does not have the required number of numeric 
operands, a syntax error results, and the loop terminates. 

A pair of parentheses is "cleared" when it contains just a single numeric value; 
that is: 

(numeric-value) -* numeric-value 

After performing any operation, the numeric result becomes an operand for the next 
scan. Parentheses are cleared before the next scan begins. 



"Case Studies" in Evaluating Expressions 

Here are some representative cases of expressions showing how they are evaluated 
by the ICE-86A emulator. In some examples, the steps in evaluation are shown, but 
most show just the overall result. Table 5-7 summarizes the cases. The EVALUATE 
(EVA) command used in these examples performs the evaluation and displays the 
result in the four numeric radixes (Y, Q, T, and H), plus the ASCII printing 
equivalent (if any) in single quotes. The examples in this section assume the initial 
conditions shown in table 5-8. This table also describes the special notation used in 
some of the examples. The examples also assume SUFFIX = T; that is, any number 
without an explicit radix is decimal. 

Casel: EVALUATE operand 

An expression can be composed of just a single operand, requiring at most a lookup 
to produce a numeric result. 

Examples: 

*EVA10 

1010Y 12Q 10T AH " 
* EVA IP 

1 000000000000 Y 10000Q 4096T 1000H ' ' 
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RESOLVE ALL 
PRIMARIES TO 
NUMBERS 




FIND INN 
PAREN1 


ERMOST 
•HESES 






IDENTIFY OPERATORS 
WITH HIGHEST 
PRECEDENCE 






SELECT LEFTMOST 
SUCH OPERATOR 



0 




CLEAR INNERMOST 
PARENTHESES 



Figure 5-1. A Simple Model of Evaluation 



162554-6 
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* EVA' -.A A 

1 0000000000000 Y 20000Q 8192T 2000H " 

*EVA1234:5678H 
T234:5678H179B8H 

Case 2: EVALUATE unary-operator operand 

A unary operator with a single primary operand evaluates to a number. 
Examples: 
*EVA -2 

1111111111111110Y 17776Q 65534T FFFEH T 

* EVA BYTE .AA 

10001 1Y 43Q 35T 23H '#' 

*EVANOTIP 

1110111111111111Y 167777Q 61439T EFFFH '0' 



Table 5-7. Representative Cases of Expressions 



Case 


Expression 


Precedence 


Result of Lookup 
Plus One Scan 


1 


operand 


None 


number 


2 


unary-operator operand 


Any 


number 


3 


operand binary-operator operand 


Any 


number 


4 


operand b1 operand b2 operand 


b1 » = b2 
b2 » b1 


number b2 number (case 3) 
number b1 number (case 3) 


5 


operand b1 (operand b2 operand) 


b2 » b1 
b1 » = b2 


number b1 number (case 3) 
number b1 number (case 3) 


6 


u1 operand b1 operand 


u1 » b1 
b1 » u1 


number b1 number (case 3) 
u1 number (case 2) 


7 


operand b1 u1 operand 


u1 » b1 
b1 » u1 


number b1 number (case 3) 
ERROR (See case 8) 


8 


operand b1 (u1 operand) 


u1 » b1 
b1 » u1 


number b1 number (case 3) 
number b1 number (case 3) 


9 


u1 u2 operand 


u2 » u1 
u1 » = u2 


u1 number (case 2) 
ERROR (See case 10) 


10 


u1 (u2 operand) 


u2 » u1 
u1 » = u2 


u1 number (case 2) 
u1 number (case 2) 



Case 3: EVALUATE operand binary-operator operand 



The binary operator is applied to its two operands to produce a numeric result. 
Examples: 

* EVA 1.0 + 20 

11110Y 36Q 30T 1EH " 
*EVA.AA>10 

1111111111111111 Y 177777Q 65535T FFFFH " 
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*EVA.AAORIP 

11 000000000000 Y 30000Q 12288T 3000H '0' 

* EVA 01 00:001 OH + .AA 
0100:2010H 03010H 

Table 5-8. Conditions and Notation for Examples 



Conditions 



All memory locations are accessible (none are GUARDED). 
SUFFIX = T (implicit radix is decimal). 
IP = 1000H 

DEFINE. AA = 2000H 
DEFINE. BB = FFFFH 
BYTE 1000H = 3EH 
BYTE 2000H = 23H 



Notation 



» has higher precedence than. 

»= has higher or equal precedence. 

u1,u2,... unary operators 

b1,b2,... binary operators 



Case 4: EVALUATE operand bl operand b2 operand 

The binary operator with the highest precedence is evaluated first. If they have equal 
precedence, bl (the leftmost) is evaluated first. 

A. b1»=b2 

Examples: 

*EVA10 + .AA-IP 

1000000001 01 0Y 10012Q 4106T 100 AH " 
*EVA10* .AA-IP 

11 000000000000 Y 30000Q 12288T 3000H '0' 
*EVAIP = .AAOR.BB 

1111111111111111Y 177777Q 65535T FFFFH " 

*EVA1+2-3 

0Y 0Q 0T OH " 

*EVA3*2 + 1 

111Y 7Q 7T 7H " 



B. b2»b1 

Examples: 

*EVA2 + 3*4 

1110Y 16Q 14T EH " 

*EVA .BB OR .AA AND IP 

1111111111111111Y 177777Q 65535T FFFFH 

*EVA10R2AND3 
11 Y 3Q 3T 3H " 
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Case 4 also fits expressions of any length that use only binary operators. Here is an 
example showing the steps in the evaluation. 



Step 


Operation 


Result 


0 


Expression 


.BB OR IP = .AA AND AFAFH XOR .AA MOD 277 


1 


Lookup 


FFFFH OR 1000H - 2000H AND AFAFH XOR 200QH MOD 277 


2 


MOD 


FFFFH OR 1000H = 2000H AND AFAFH XOR 9FH 


3 




FFFFH OR 0 AND AFAFH XOR 9FH 


4 


AND 


FFFFH OR 0 XOR 9FH 


5 


OR 


FFFFH XOR 9FH 


6 


XOR 


FF60H 



More examples: 

*EVA 2 XOR 3 MASK 41 MOD 33 
10 2Q 2T 2H " 

>EVA2*3 + 5/3 / + 7 
1101Y 15Q 13T DH " 

*EVA2 + 3*5 + 7 

11000Y 30Q 24T 18H " 



Case 5: EVALUATE operand bl (operand bl operand) 

Binary operator b2 is evaluated first, even if it has lower precedence than bl. Use 
parentheses when bl must be evaluated before bl . 

Examples: 

*EVA2*(3 + 5) 

10000Y 2Q 16T 10H " 

*EVA .BB / (.AA MASK AFAFH) 
111Y 7Q 7T 7H " 

This case can be generalized to include any number of binary operators and any 
arrangement of parentheses. For example: 



Step 


Operation 


Result 


0 


Expression 


10* (44 + (17 * 15-6) / 7) 


1 


2nd* 


10* (44 + (255-6) 1 7) 


2 




10 * (44 + (249)/ 7) 


3 


Clear (1) 


10 * (44 + 249 / 7) 


4 


/ 


10* (44 + 35) 


5 


+ 


10* (79) 


6 


Clear () 


10*79 


7 


1st* 


790 



Case 6: EVALUATE ul operand bl operand 
Precedence decides which operator is evaluated first. 
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A. u1»b1 

Examples: 

*EVA-10 + 22 

1100Y 14Q 12T CH " 

*EVA BYTE .AA OR .BB 

1111111111111111 Y 177777Q 65535T FFFFH " 

*EVA NOT .BB AND AFAFH 
OY OQ OT OH " 

B. b1»u1 

Examples: 

*EVA BYTE .AA - 1000H 
111110Y 76Q 62T 3EH " 

*EVANOT.BB/23 

1111010011011110Y 172336Q 62686T F4DEH 'Tt' 
Case 7: EVALUATE operand bl ul operand 

The unary operator must have higher precedence than the binary operator. 

A. u1 » b1 is valid. 
Examples: 

*EVA10*-2 

1111111111101100Y 177754Q 65516T FFECH 'L' 

*EVA .AA AND NOT .BB 
OY OQ OT OH " 

B. b1»u1 

This produces an error. The operator bl must be evaluated next, and requires two 
numeric operands, but ul operand has not yet been evaluated to a numeric result. 

Examples: 

*EVA 10 + BYTE .AA 
ERR 80:SYNTAX ERROR 

*EVA .AA MASK NOT. BB 
ERR 80:SYNTAX ERROR 

Case 8: EVALUATE operand bl (ul operand) 

Unary operator ul is evaluated first, even if it has lower precedence than binary 
operator bl . Parentheses must be used when ul has lower precedence than bl . 

Examples: 

*EVA 10 + (BYTE .AA) 
101101Y 55Q 45T 2DH '-' 
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*EVA.AA MAKE (NOT. BB) 
OY OQ OT OH " 

Case 9: EVALUATE ul u2 operand 

Unary operator u2 must have higher precedence than ul to evaluate without an 
error. 

A. u1 » u1 is valid. 

Examples: 

*EVA BYTE - EFFFH 

10000000Y 200Q 128T 80H " 

* EVA NOT BYTE .AA 

11111111110111100Y 177734Q 65500T FFDCH " 

B. u1»=u2 

Examples of this case shown below result in an error. 

Examples: 

*EVA BYTE NOT .AA 
ERR 80:SYNTAX ERROR 

*EVA - BYTE .AA 

ERR 80.SYNTAX ERROR 

*EVA BYTE BYTE 1000H 
ERR 80:SYNTAX ERROR 

*EVA--5 

ERR 80:SYNTAX ERROR 
Case 10: EVALUATE ul (u2 operand) 

Unary operator u2 is evaluated first, even if it has lower precedence than ul . Paren- 
theses must be used when u2 has lower precedence than ul . 

Examples: 

*EVA BYTE (NOT .AA) 
111101Y 75Q 61T 3DH 

*EVA - (BYTE .AA) 

11111111110111101Y 177735Q 65501T FFDDH ']' 

*EVA BYTE (BYTE 1000H) 
11111110Y 376Q 254T FEH T 

*EVA-(- 5) 

101Y 5Q 5T 5H " 

Two other "cases" can be diagrammed as: 

operand b1 b2 operand 
operand i b2 operand 
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Both forms produce an error no matter which operator has higher precedence, and 
no arrangement of parentheses can resolve the error. 

These examples show the basic ways to control evaluation with and without paren- 
theses. Parentheses must be used when two operators are concatenated and the sec- 
ond operator has lower precedence than the first. 



Command Contexts 

All expressions produce numeric values as results. The interpretation or use of the 
result depends upon the command that contains the expression. The term numeric- 
expression means an expression in a numeric command context. Numeric command 
contexts treat the result as a numeric value; all bits are significant. 

The term boolean-expression means an expression in a boolean command con- 
text. Only integer values may be used in boolean contexts. Boolean command con- 
texts test only the least-significant bit (LSB) of the result, to obtain a TRUE or 
FALSE value. The result of a boolean expression is TRUE if its LSB is 1, FALSE if 
its LSB is 0. Thus, any number can have a boolean interpretation. 

The BOOL command can be used instead of the EVALUATE command to display 
the evaluation of an expression as TRUE or FALSE. 

A boolean expression uses relational and logical operators to manipulate 
TRUE/FALSE values. When a relational operator is evaluated, the result is always 
either 0 (FALSE) or FFFFH (TRUE). These results can have a numeric interpreta- 
tion, but relational operators have limited usefulness in numeric contexts. 

When logical operators are applied to TRUE/FALSE values, the results are also 
boolean. Specifically: 



NOT: NOT FALSE -TRUE 
NOT TRUE -FALSE 



AND: TRUE AND TRUE -TRUE 
TRUE AND FALSE - FALSE 
FALSE AND TRUE - FALSE 
FALSE AND FALSE - FALSE 



OR: TRUE OR TRUE - TRUE 
TRUE OR FALSE -TRUE 
FALSE OR TRUE -TRUE 
FALSE OR FALSE - FALSE 



XOR: TRUE XOR TRUE - FALSE 
TRUE XOR FALSE -TRUE 
FALSE XOR TRUE -TRUE 
FALSE XOR FALSE - FALSE 



In addition to numeric and boolean contexts, there are several other contexts that 
control the interpretation or use of a number or expression. These contexts are sum- 
marized in table 5-9 for reference. 
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Table 5-9. Command Contexts 



Type of Entry 


Contexts 


Interpretation 


Limitations 


Examples of Use 


Numeric expression 


Set and change 
commands, etc. 


16-bit unsigned 
number; bit size 
may be reduced to 
fit destination. 


All operands and operators 
allowed. Numeric constant 
without suffix is interpreted 
in current default radix. 


IP = .AA*256T + 10FFFH 


Boolean expression 


BOOL, IF, 

UNTIL, 

WHILE 


LSB = 0- FALSE 
LSB = 1-TRUE 


All operands and operators 
allowed. Numeric constants 
without suffix are interpreted 
in current default radix. 


.AAAND.BBANDNOT.CC 


Address 


FROM, 
content- 
operator, parti- 
tion, SAVE 


Pointer to 
memory or 
lo-Dii (or Tewer; 
address in 
memory or I/O. 


Only arithmetic operators are 
. allowed outside of the outer- 
most parentheses. Constant 
without suffix are interpreted 
in the current default radix. 


GO FROM BB + 10 


Decimal number 


statement- 
number, MOVE, 
PRINT 


positive number 


No operators are allowed 
outside the outermost paren- 
theses. All constants without 
suffix are decimal. 





5-22 



CHAPTER 6 
EMULATION AND TRACE 
CONTROL COMMANDS 



Chapter 6 contains discussions, examples, and syntax summaries for each of the 
1CE-86A emulation and trace control commands. 



The following brief outline of Chapter 6 shows how the emulation and trace control 
commands have been classified. 



Emulation Control Commands 

Set Breakpoint Register Command 
Set Tracepoint Register Command 
GO Command 
GR Command 
STEP Command 

Display Emulation Register Command 

Set CLOCK Command 

Display CLOCK 

Set RWT1MEOUT Command 

Display RWTIMEOUT Command 

ENABLE/DISABLE RDY Command 



Trace Control Commands 

Set TRACE Display Command 
ENABLE/DISABLE TRACE Command 
Display TRACE 

MOVE, OLDEST, and NEWEST Commands 
PRINT Command 



Emulation Control Commands 



The ICE-86A emulator contains an 8086 as the emulation processor. During emula- 
tion, this processor executes the instructions in the user program that have been 
mapped and loaded into the ICE-86A system. The operations of the user system can 
be monitored through the 8086 processor signals. The commands in this section 
allow you to specify the starting address where emulation is to begin, and to specify 
and display the software or hardware conditions for halting emulation and returning 
control to the console for further commands. 
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The commands in this section are as follows: 



COMMAND 

Set Breakpoint-Register 
Set Tracepoint-Register 

GO command 
GR command 

STEP command 

Display Emulation Register 

Set CLOCK 
Display CLOCK 
Set RWTIMEOUT 

Display RWTIMEOUT 
ENABLE/DISABLE RDY 



PURPOSE 

Set match condition for halting emulation. 

Set match condition for starting or halting trace data 
collection. 

Begin real-time emulation. 

Enable or set and enable breakpoint registers to 
halt emulation. 

Execute single-step emulation. 

Display GO-register, breakpoint and tracepoint 
register settings. 

Designate system clock. 

Display clock setting. 

Enable or disable halting of emulation and error 
message on memory access timeout. 

Display current setting of memory access timeout. 

Enable or disable user-ready signal for memory 
access. 



Discussion 

The emulation control commands tell the ICE-86A emulator where to start emula- 
tion and when to halt emulation. 

To initialize for emulation, you map the locations in prototype and ICE-supplied 
memory that are to be accessible to the ICE-86A emulator, and load your program 
code into mapped locations. After the code has been loaded, the ICE-86A emulator 
initializes for emulation as follows: 

• The instruction pointer (IP) and code segment register (CS) are loaded with the 
address of the first executable instruction in your program. 

• The GO-register (GR) is set to FOREVER. The setting of GR identifies the 
combination of factors that are enabled to halt emulation. The setting 
FOREVER means no factors are enabled. 

• Both breakpoint registers (BRO and BR1) are set to don't care and initially 
disabled. 

Now you can begin emulation by entering the command GO, followed by a carriage 
return. At the command GO, the following occurs: 

• Emulation begins with the instruction at the address that is in the IP and CS; 
this is the first executable instruction in your program. 

• External signal EMUL is set high (1) to tell an external device that emulation is 
occurring. 

• The message EMULATION BEGUN is displayed at the console. 

• Emulation continues until you press the ESC key, or until a fatal error occurs. 
(See Appendix B for error messages.) 

Now, if you press the ESC key, the following happens: 

• The ICE-86A emulator completes executing the current instruction. 
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• Emulation halts; the IP and CS contain the address of the next instruction to be 
executed. 

• The message EMULATION TERMINATED, CS:IP=bbbb:ddddH is 
displayed. The value displayed is the address of the next instruction to be 
executed. 

• The message PROCESSING ABORTED is displayed, acknowledging the user 
abort (ESC key). 

This is the simplest case of starting and stopping emulation. When the GO-register is 
set to FOREVER, you can enter the command GO to start emulation at the current 
CS:IP address, and press the ESC key to halt emulation. 

Instead of starting wherever the CS:IP happens to be, you may specify the address 
you want for each GO command. There are two ways to do this. First, you can set 
the CS:IP directly to any desired address with commands of the form CS = expr, IP 
= expr, then enter the GO command to start emulation at that address. Second, you 
can specify the starting address as part of the GO command; this form of the GO 
command is as follows: 

GO [FROM address } 

The meta-term address means the following type of entry: 

numeric-expression A numeric expression is evaluated to give the address 

(see Chapter 5). (Table 5-9 specifies restrictions.) 

For example, to start emulation with the instruction at memory location 3000H, you 
could enter: 

CS = 0 
IP = 3000H 
GO 

Or, you can enter: 

GO FROM 3000H 
The effect is the same either way. 
The following form of the GO command is also valid: 

GO [FROM address] FOREVER 

This form of the GO command enables you to optionally select the starting address 
and to disable the factors that halt emulation. For example, to start emulation with 
the instruction at memory location 3000H and to set the GO-register to FOREVER, 
you can enter: 

GO FROM 3000H FOREVER 

The effect of this command is to start emulation with the instruction at location 
3000H. Emulation will stop only when you abort processing. 

The ICE-86A emulator has two breakpoint registers, BRO and BR1. Each of these 
registers can be set to hold a "match condition" that can be used to halt real-time 
emulation when the register is enabled. A second form of the GO command can be 
used to both load and enable breakpoint registers. This form of the GO command is: 
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GO [ FROM address ] [T\LL match-condition [ j °J D } match-condition ]] 

This command loads the match-conditions into the breakpoint registers and enables 
the registers to halt emulation on the desired set of system conditions contained in 
these match-conditions. Match conditions are of two types: 

(execution-match-condition \ 
match-condition =< A . , , .... > 

I non-execution-match-condition ) 

The breakpoint registers may be set to contain either type of match-condition. 

Execution Match Condition 

An execution-match-condition consists of a single, 20-bit field plus the keyword 
EXECUTED, where each address bit can take any one of three values: 0, 1, or 
"don't care." An execution match condition is examined when the 8086 CPU exe- 
cutes an instruction byte, that is, when the byte is fetched from the 8086 instruction 
queue. The condition "matches" when the executed instruction byte was obtained 
from a memory location whose 20-bit address matches the contents of the selected 
breakpoint register. 

( address EXECUTED \ 
execution-match-condttion =\ . . . \ 

I marked-const EXECUTED I 

Entering an address causes all 20 bits of the match condition to be loaded with 
0-and 1-bit values. The address contains a base and displacement (e.g., .X or 
50:3000H); note that a single constant is evaluated module 65536 (e.g., 12345H is 
the same as 2345H— use 1234.5H to get all 20 bits). Entering a masked-constant 
causes the 20-bit field to contain 0,1, or "don't care" values. The "don't care" 
values are ignored. The masked-constant can be 20 bits in length. 

The following examples illustrate the use of this form of the GO command. The 
examples assume that the initial contents of the breakpoint registers are as shown 
below: 

BRO = XXXXXH (all bits set to "don't care") 
BR1 = XXXXXH (all bits set to "don't care") 

Also, in these examples, the address of .START is 0000:0002H, .DELAY is at 
0000:00DEH, and .DISPLAY is at 0000:0098H. The examples will list a GO com- 
mand followed by the contents of the breakpoint registers as set by the command. 

1 . Go from .START until the first instruction byte in .DELAY is executed. 

GO FROM .START TILL .DELAY EXECUTED 

BR0 = 000DEH E (000DEH is the 20-bit address of .DELAY, the last E specifies 
"EXECUTED") 

BR1 = XXXXXH (BR1 is unchanged) 

This command loads BRO with the given match condition: ".DELAY 
EXECUTED"). 

2. Go from .START until address 0200H is executed. 

GO FROM .START TILL 0200H EXEC 
BRO = 00200H E 
BR1 = XXXXXH 

This command loads the numeric address and "executed" status into BRO and 
leaves BR 1 unchanged. 
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3 . Go from . START until address 1 00:0200H is executed . 

GO FROM .START TILL 100:0200H EXEC 
BR0 = 01200HE 
BR1 = XXXXXH 

The pointer address 100:0200H and "executed" status are loaded into BRO, and 
BR1 is unchanged. 

4. Go from .START until an address in an address range specified by a masked 
constant is executed. 

GO FROM .START TILL 10XXH EXECUTED 

BR0 = 010XXHE 

BR1 = XXXXXH 

The masked constant address loaded into BRO specifies a range of addresses: 
01000H through 010FFH. BRO remains unchanged. 

5. Load two execution match conditions, one in each breakpoint register, and 
'OR' the conditions. 

GO FROM .START TILL .DELAY EXEC OR .DISPLAY EXEC 

BRO = 000DEH E (Halt when .DELAY is executed.) 

BR1 = 00098H E (Halt when .DISPLAY is executed.) 

This command sets emulation to halt when either the instruction located at loca- 
tion 000DEH (.DELAY) or location 00098H (.DISPLAY) is executed. 

6. Load two execution match conditions and 'AND' them. 

GO FROM .START TILL .DELAY EXEC AND .DISPLAY EXEC 
BRO = 000DEH E (Halt when .DELAY is executed.) 
BR1 = 00098H E (Halt when .DISPLAY is executed.) 

ERR AE.INVALID "AND" IN GO-REG(Error message generated by this command) 

This command sets emulation to halt when the instruction located at location 
000DEH (.DELAY) 'AND' the instruction located at location 00098H (.DISPLAY) 
are executed. Execution of two separate instructions cannot occur at the same time. 
Therefore an error message is generated by this command, and the command is not 
executed. 



Non-Execution Match Condition 

The non-execution-match-condition must contain one or more of four types of 
fields: a set of addresses, a list of bus status types, a set of data values, and a seg- 
ment register designation. A non-execution-match-condition matches whenever a 
breakpoint that contains a set of one or more of the above fields matches corre- 
sponding state values in the user system during real-time or single-step emulation. 



Address-match-range, match-status-list, data-match-range, and segment-register- 
usage must be used in the order shown. At least one of these fields must be entered in 
a given command to establish a non-execution match condition. 



non-execution-match-condition = < 



\ 



address-match-range 
match-status-list 
data-match-range 
segment-register-usage 
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Address Match Range 

An address-match-range may consist of a single address or masked constant, an 
"unlimited" range of addresses, or a set of match partitions. If an "unlimited" 
range of addresses are to be entered, an address value modified by the mnemonic UP 
or DOWN is entered. UP implies any address value equal to or greater than the 
stated address. DOWN implies any address value equal to or less than the stated 
address. The match partition may be any of three types: partitions, memory 
references, and/or typed memory references. If the address-match-range contains 
more than one partition, all partitions must have the same base and their 
displacements must lie within a lK-byte range that begins at an even address. If there 
is only a single partition, it must lie within a lK-byte range to be contained in a single 
breakpoint register. If the partition does not lie within a IK range, two registers are 
required to hold the partition. Therefore an address-match-range can be defined as: 



~~ address : : masked-const 
address UP '.'.address DOWN 



addres-match-range ■■ 



partition 

OBJECT memory-reference 
OBJECT typed-memory-reference J 



1 



All references to a "lK-byte range" should begin at an even address. For example, 
'BRO =1000:20 LEN IK' is valid, but 'BR0=1000:21 LEN IK' is not valid. 

By expanding the definition of partitions and memory reference to their component 
parts, the definition of address-match range becomes: 



address : : masked-const 
address UP :: address DOWN 



address TO address 
address LENGTH address 
OBJECT BYTE address 
OBJECT WORD address 
OBJECT S INTEGER address 
OBJECT INTEGER address 
OBJECT POINTER address 
OBJECT REAL address 
OBJECT DREAL address 
OBJECT TREAL address 
OBJECT typed-memory-ref 



address-match-range = 



For example, an address-match-range of a single address would be 3000H, whereas 
using the masked constant 30XXH would result in a match range of 3000H through 
30FFH. Two examples of the use of partitions in a match range are: 



4000 TO 4100 



and 



4000 LENGTH 101 



Both of these partition specifications result in the range of addresses, 4000 through 
4100. 



A sequence of discontinuous addresses can be specified by: 

OBJECT BYTE 4000, OBJECT WORD 3188, OBJECT !!MOD1 ISYMSAM, ... 
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This would result in a string of discontinuous match addresses, the third address in 
the above string being specified by a typed memory reference. OBJECT indicates a 
partition beginning at the low address of the memory object and whose length is the 
length of the object. In the above example, 'OBJECT BYTE 4000' specifies a one- 
byte partition whose address is 4000. 'OBJECT WORD 3188' specifies a two-byte 
partition starting at 3188 and ending at 3189. 'OBJECT .. MODI .SYMSAM' 
specifies a partition starting at the address given in the symbol table for MMOD1 
ISYMSAM and whose length is specified by the memory type of symbol .SYMSAM. 
For example if .SYMSAM is type WORD, the partition will be two bytes in length. 

OBJECT REAL 4000, OBJECT DREAL 5000, OBJECT TREAL 6000 



In the above example, 'OBJECT REAL 4000' specifies a four-byte partition at 
address 4000. 'OBJECT DREAL 5000' specifies an eight-byte partition at address 
5000, and 'OBJECT TREAL 6000' specifies a ten-byte partition at address 6000. 



Match Status List 



The match-status-list field matches whenever the 8086 bus status is any of those 
listed in the match status list: 



READ 

WRITTEN 

INPUT 

OUTPUT 

FETCHED 

HALT 

ACKNOWLEDGE 



match on memory read other than an instruction fetch, 
match on memory write, 
match on an I/O read, 
match on an I/O write. 

match on a memory read into the execution queue, 
match on 8086 halt. 

match on 8086 interrupt acknowledge. 



A match-status-list may consist of one or more of the above bus status types and 
they may be listed in any order: 



READ 

WRITTEN 

INPUT 

OUTPUT 

FETCHED 

HALT 

ACKNOWLEDGE 



match-status-list = 



An example of a match-status-list would be: 

FETCHED, READ, HALT, WRITTEN, ACKNOWLEDGE 



Data Match Range 

The data-match-range field can be used to specify data values. The syntax is similar 
to address-match-range, except the OBJECT form is not allowed. In this case, the 
values specified by address will be treated as data values and used to match against 
values on the 8086 address/data lines at data time. 



data-match-range = VALUE 



address : : masked-const 
address UP '.'.address DOWN 
partition 
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Data values must be integers. All data references in the 8086 are on even byte boun- 
daries; therefore data match conditions must be used with caution. 

• A 16-bit data value matches if that value is accessed on an even-byte boundary 
(i.e., low-order byte of data at an even address). 

• An 8-bit data value must be specified as either an even byte (by giving 8 "don't 
care" bits in the high-order byte) or an odd byte (by giving 8 "don't care" bits 
in the low-order byte). 



Segment Register Usage 

The segment-register-usage field is used to specify one of the four segment registers. 
A match occurs whenever the segment register used in an effective address calcula- 
tion is the one specified in the segment-register-usage field. Segment register usage 
occurs at data time. 



segmen t-regis ter- usage 



USING SS 
USING CS 
USING DS 
USING ES 



Match Condition Restrictions 

Figure 6-1 illustrates a detailed specification of the non-execution-match-condition . 
The following examples illustrate a set of restrictions that must be observed in the 
use of match conditions in emulation commands. 

Data values, bus status, and segment register usage come out of the 8086 at data- 
time. Address values and bus status are available at address-time. The following 
restrictions apply to match conditions: 

• Breakpoint register BRO cannot contain data-time values at the same time 
breakpoint register BR1 contains address-time values if the two registers are 
ANDed (the reverse is permissible). 

• Neither BRO nor BR1 may contain an execution-match-condition if they are to 
ANDed. 

A warning message is issued after a Set BR command or a Set GR command if the 
command results in either of the above conditions. An Error is issued on a GO com- 
mand if the command results in either of the above conditions. 

• If a match-condition specifies both address and data or segment register usage, 
the match condition requires both breakpoint registers; hence this match- 
condition cannot OR/AND with another match-condition. 

All partitions in a multi-partition match condition must have the same base value. 
For example, the following command generates the error message shown: 

GO FROM .START TILL 0:0000 LEN 1 , 100:1000H 2 READ 
ERR AD:DIFFERING BASIS (error message) 

All the displacement values must be within a lK-byte range (beginning on an even 
address) to be contained in a single breakpoint register. Displacements may exceed 
IK only if there is a single partition. 

The following match condition cannot be contained in one breakpoint register: 
GO FROM .START TILL 0:0000 LENGTH 2048T WRITTEN 
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The above command would require both breakpoint registers as the partition is 2K- 
bytes in length. 

The following command would generate an error as two partitions are specified and 
the displacements exceed IK. 

GO FROM .START TILL 0, 2048T WRITTEN 

The following command would generate an error as the partition requires both 
breakpoint registers. Therefore the partition \ BEGIN' cannot be entered. 

GO FROM .START TILL 0 LEN 2048T, .BEGIN W 

Segment register usage can only be used in conjunction with a single match value as 
illustrated in the example below. 

GO FROM .DELAY TILL .MAINTIME READ USING DS 

The last form of the GO command is in the following format: 

GO [FROMaddress][J\LLbreak-reg ^j^p 0 j ^ea/c-regf ]J 

where break-reg references breakpoint register BRO, BR1, or BR. This command 
form is used when the breakpoint registers have been set prior to the entering of this 
command. The command enables the referenced breakpoint register but does not set 
its contents. The Set Breakpoint command, GR command, or a previous GO com- 
mand must be used to set the required breakpoint registers. Care is required in 
AN Ding two breakpoint registers in this command. Only two non-execution-match- 
conditions can be "ANDed". An error results if either of the conditions described 
below occur. 

• BRO contains data values or segment register usage, and BR1 contains address 
values. 

• Either of the breakpoint registers contains an execution-match-condition. 

NOTES 

During the first cycle of emulation, the ICE-86A emulator fetches 
the word at absolute memory location eight. The word is 
immediately flushed from the queue; it is never executed. The ICE 
emulator user should be aware that these memory operations are 
part of the normal operation of the emulator and that they do not 
impact successful application of the ICE-86A emulator. 

The user may experience excessive response times for external bus 
requests while setting breakpoints. The ICE-86A firmware loads 
the breakpoint registers; there are 4096 steps involved in loading 
these registers. Each step takes up to 500 microseconds to com- 
plete. In between each step there are periods of inactivity (break- 
points not being loaded) of approximately equal length, about 
several hundred microseconds in duration. While each of the 
breakpoint-loading steps is being executed, the Request/Grant 
response capabilities of the ICE-86A emulator are temporarily 
disabled. (During the inactive periods, the response capabilities are 
enabled.) Hence, external bus requests may not be answered as 
quickly as under normal circumstances. 

Breakpoint Restrictions 

There are two cases in which an interrupt request is not recognized until after the 
following instruction. A MOV (move) to segment register instruction or a POP seg- 
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address : : masked-const 



address UP : : address DOWN 



address TO address 
address LENGTH address 



OBJECT BYTE address 
OBJECT WORD address 
OBJECT SINTEGER address 
OBJECT INTEGER address 
OBJECT POINTER address 



OBJECT typed-mem-ref 



READ 

WRITTEN 

INPUT 

OUTPUT 

FETCHED 

HALT 

ACKNOWLEDGE 



VALUE address : : VALUE masked-const 



VALUE address UP 
VALUE address DOWN 



VALUE [ address TO address 1 

[ address LEN GTH address J , 



USING SS 
USING CS 
USING DS 
USING ES 



-{address-match-range) ■ 



(match- 
- status- 
list) 



(data match-range) 



(segment- 
■*— register- 
usage) 



Note: (address-match-range), (match-status-list), (daia-match-range), and (segment- 
register-usage) must be used in the order shown. At least one of these fields must be 
entered in a given command and no field may be repeated in the command. 



Figure 6-1 . Non-Execution Match Condition 
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ment instruction will cause interrupt recognition to be inhibited until the following 
instruction has been executed. This mechanism protects a program that is changing 
to a new stack (by updating SS and SP). If an interrupt were recognized after SS had 
been changed, but before SP had been altered, the processor would push the flags, 
CS and IP, into the wrong area of memory. It should be noted that whenever a seg- 
ment register and another value must be updated together, the segment register 
should be changed first, followed immediately by the instruction that changes the 
other value. 

If your code contained the following sequence of instructions: 

MOV DS,DATASEG 

MOV ES,EXTRASEG 

MOV SS,STACKSEG 

MOV SP,STACKP01NTER 

' JMP START 



No interrupts will be recognized until the MOV SP instruction has completed. 

Similarly, if your code contained the following sequence of instructions: 

POP DS,DATASEG 

POP ES,EXTRASEG 

POP SS,STACKSEG 

POP SP,STACKPOINTER 

JMP START 



No interrupts will be recognized until the POP SP instruction has completed. Nor- 
mally the single step mode will generate a type 1 interrupt after each instruction. A 
breakpoint is recognized by a type 3 interrupt. The MOV and POP instructions 
described above will cause these interrupts to be inhibited until the instruction 
following the MOV or POP has been executed. 

Since the ICE-86A emulator uses the NMI to effect breakpoints for SINGLE/STEP 
and GO emulation, the break will be inhibited as long as the interrupt protection 
feature is in effect, i.e., an attempt to break at the MOV ES,EXTRASEG instruc- 
tion will actually break when the MOV SP instruction has completed, resulting in 
the IP pointing to the JMP START instruction. 

A third case in which program execution does not terminate at the specified break- 
point occurs due to 8086 queue operations. Execution breakpoints are complicated 
by the necessity to trace the 8086 queue operations, and thus, there is no guarantee 
that execution will be terminated immediately after the instruction specified. 

If the instruction requires only two clock cycles to execute, then (depending on the 
current queue depth) the emulator may slip past the requested breakpoint by one 
instruction. Due to the complexities of the breakpoints and the exact timing uncer- 
tainties, the ICE module will not detect such a slip. 

The user may determine this type of slip, however, by examining the trace data and 
comparing the next to last instruction in the trace data to the potential break 
conditions. 
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Setting The Go-Register 

To enable either (or both using BR) of the breakpoint registers as a halt condition, 
you ean use a set GR command of the form: 

GR = halt-go-condition 

The meta-term halt-go-condition means any of three exclusive types of halt 
conditions: 



Using the FOREVER condition in the Go-Register command: 

GR = FOREVER 
would disable both breakpoint registers. 

The following command would enable BR1, once BR1 had been set using the Set 
Breakpoint Command. 

GR = TILL BR1 

Both registers can be enabled and ORed with the following command: 
GR = TILL BR1 OR BRO 

Both registers can be set within a limited range and then combined to expand that 



If BRO were set to 800 UP and BR1 were set to FFEFF DOWN the command: 

GR = BRO AND BR1 
would break between 800 and FFEFF. 

BRO would be loaded with a match condition and enabled with the following 
command: 

GR = TILL 3000H WRITTEN, FETCHED 

The following command would load BRO with the first match condition and BR1 
with the second stated match condition: 

GR = TILL 3000H WRITTEN, FETCHED OR INPUT VALUE 0123 USING DS 

BRO would contain the match condition 3000H WRITTEN, FETCHED and BR1 
would contain the match condition INPUT VALUE 0123 USING DS and both 
registers would be enabled and ORed. 

The following command would require both breakpoint registers to contain the 
match condition: 

GR = TILL .DELAY FETCHED OR READ VALUE .MAINTIME USING DS 




range. 
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BRO would contain the match condition .DELAY FETCHED and BR1 would con- 
tain the match condition READ VALUE .MAINTIME USING DS. 

The following command would require both breakpoint registers to contain match 
conditions that are "ANDed": 

GR = TILL ISIOETIME READ AND VALUE 8 

BRO would contain the condition .S1DETIME READ and BR1 would contain the 
match condition VALUE 8 . These conditions are ANDed. 



Setting Tracepoint Registers 

The ICE-86 emulator has two tracepoint registers, ONTRACE and OFFTRACE. A 
tracepoint register may only contain a non-execution match condition. Also the 
match range may only contain an address, masked constant, or data, and segment 
register usage may not be used with an address condition. For example, the follow- 
ing commands are valid: 

ONT = 3000H WRITTEN, FETCHED 
OFF = INPUT VALUE 0123 USING DS 

However, the commands: 

OFFTRACE = 3000H EXECUTED 
ONTRACE = 3000H READ USING CS 

are invalid as EXECUTED is invalid in a tracepoint, and the segment register CS is 
specified with an address condition. 



Command Signal Timeout 

When the 8086 accesses INTELLEC or DISK mapped memory, a command signal 
timer starts counting. If the access is not completed before it times out, the ICE-86A 
emulator will cause the READ and WRITE command signals to go inactive to the 
user system. The RWTIMEOUT commands are used to set and display the current 
setting of the command signal timer. 



Emulation Timer 

An emulation timer is enabled when emulation is running. The timer can be used to 
determine how long it takes the ICE-86A emulator to emulate a given segment of 
code. The timer is a 2-MHz clock (i.e., counts are intervals of 500 ns), derived from 
the crystal on the Control board. 

The timer starts when the GO command is entered, starting emulation. The timer 
starts counting at the first T3 state of the first instruction emulated. HTIMER stops 
counting where a maximum count of approximately 33 minutes is reached. TIMER 
continues counting modulo 65536. 

The timer is reset to 0 (before starting to count) when the GO command is entered 
with a FROM clause or when CS:IP is changed or when ENABLE/DISABLE 
TRACE. If you want to reset the timer without changing the current program 
counter, enter a command such as GO FROM CS:IP. 
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After emulation halts, you can display the value of the timer in the current output 
radix. The display command TIMER displays the low 16 bits of the timer value; the 
command HTIMER displays the high 16 bits of the timer value. The tokens TIMER 
and HTIMER can also be used as keyword references in commands and expressions. 

With the timer, you can measure the real elapsed time required to emulate a given 
code sequence. The elapsed time can then be compared to the calculated time based 
on the number of clock states in each instruction and the speed of the system clock. 
Note that code mapped to user runs at real-time; the timer value for code mapped to 
prototype memory is the real-time value. 

A special application of the emulation timer is optimization of coprocessor code. 
When the emulated 8086 CPU is configured, for example, in local mode with an 
8087 NDP (Numeric Data Processor), then the two microchips can execute instruc- 
tions in parallel. In general, the 8087 coprocessor fetches its instructions out of the 
8086 instruction stream and begins to perform a floating point calculation; the 8086 
will continue executing additional code while the 8087 proceeds with this calcula- 
tion. The 8086 will execute a WAIT instruction when it can no longer execute code 
without the result of the 8087 calculation (inserted in code by user or compiler), and 
will continue when the 8087 finishes executing and releases the TEST pin. Optimiza- 
tion, then, consists of reducing the amount of time the 8086 processor spends 
waiting for the 8087 NDP to complete its instructions. By using the emulation timer, 
the operator can determine the amount of time floating point instructions take to 
execute in the 8087 coprocessor, and plan the 8086 code to execute in approximately 
the same length of time. 
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Set Breakpoint Register Command 

(1) break-reg = address EXECUTED .'.masked-const EXECUTED 

(2) break-reg = [address-match-range] [match-status-list] [data-match-range][seg-reg-usage] 

NOTE 

Form (2) requires that the address-match-range, match-status-list, 
data-match-range, and seg-reg-usage fields be used in the order 
shown. At least one field is required in a given command and no 
field may be repeated in the command. Restriction: the fields 
selected must fit in one breakpoint register. 

Examples: 

BR0 = 1XXXH EXECUTED 

BR1 =3000H UP WRITTEN 

BR =3000H TO 30FFH READ USING CS 

BR = 3000H LENGTH FEH, OBJECT !VAR WRITTEN 



break-reg 



address 



The name of one of the breakpoint registers (BRO, BR1) 
or BR to set both registers to the same match condition. 

The assignment operator. 

The address of the memory location or I/O port, or a 
data value. 



masked-const 



A masked constant used to define a range of memory 
locations or data values. 



EXECUTED 



Denotes that the match condition is the execution (CPU 
fetch of the instruction byte from the instruction queue) 
of the instruction byte whose address is given by address 
or masked-const. 



address-match-range A set of one or more addresses. (See Address Match 

Range in Chapter 6.) 

match-status-list A set of bus status conditions to be used as match 

parameters. (See Match Status List in Chapter 6.) 

data-match-range A set of data values to be used as match parameters. (See 

Data Match Range in Chapter 6.) 

seg-reg-usage A specification of one of the segment registers to be used 

as a match parameter. (See Segment Register Usage in 
Chapter 6.) 



NOTES 

See Breakpoint Restrictions (Chapter 6) for breakpoint interrupt 
restrictions. 

Execution breakpoints are complicated by the need to trace the 8086 queue 
operations, and thus do not guarantee that execution will be terminated 
immediately after the specified instruction. The ICE emulator may slip past 
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the breakpoint instruction and stop at the next instruction. This slippage is 
dependent on the current depth of the queue when the breakpoint instruc- 
tion requires only two clock cycles for execution. Due to the complexity of 
the breakpoints and exact timing uncertainties, the ICE emulator will not 
detect this slip. The user may determine that the slippage has occurred by 
examining the trace data and comparing the next-to-last instructions exe- 
cuted to the potential break conditions. 
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Set Tracepoint Register Command 



trace-reg ■■ 



address 
masked-const 



(address- 
match ) 
range) 



READ 

WRITTEN 

INPUT 

OUTPUT 

FETCHED 

HALT 

ACKNOWLEDGE^ 

(match- 
status- 
list) 



VALUE address 
VALUE masked-const 

(6a\a-match-range) 



USING SS 
USING CS 
USING DS 
USING ES 



(segment- 

register- 

usage) 



NOTE 

The address-match-range, match-status-list, data-match-range, and 
segment-register-usage fields must be used in a command in the order 
shown. At least one field is required in a given command and no field may 
be repeated in the command. A segment-register-usage field or data-match- 
range may not be used with an address condition (address-match-range 
field); you cannot mix address-time fields with data-time fields. 



Examples: 



ONTRACE = 2340 READ, ACKNOWLEDGE 
OFFTRACE = INPUT, OUTPUT VALUE 1234H 
ONTRACE = !X FETCHED 
ONTRACE = R,W VALUE 40XX USING ES 
OFFTRACE = USING ES 



trace-reg 

address 

masked-const 

match-status-list 

data-match-range 

segment-register-usage 



The name of one of the tracepoint registers, ONTRACE 
or OFFTRACE. 

The assignment operator. 

The address of the memory location or I/O port, or a 
data value (see Data Match Range). 

A masked constant used to define a range of memory 
locations or data values. 

See Match Status List. (Chapter 6.) 

See Data-Match Range. (Chapter 6.) 

See Segment Register Usage. (Chapter 6.) 
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GO Command 

FROM address 



GO 



Examples: 



FOREVER 
TILL break-reg 

TILL match-cond 



£ j AND | match-cond J 



GO 

GO FROM 3000H 

GO FROM .START TILL BRO 

GO FROM 3000H TILL 30Q0H EXECUTED 

GO TILL INPUT VALUE 1000 

GO FROM 1000H TILL 30Q0H TO 30FFH READ USING OS 
GO FROM 3000H TILL OBJECT POINTER START READ 



GO 

FROM 

address 

FOREVER 

TILL 



Command keyword that starts emulation, subject to the 
current start and halt conditions. 

Keyword introducing a starting address. 

The address of the memory location of the first 
instruction to emulate, i.e., the start address. 
Disables all breakpoint conditionsi emulation can be 
stopped only by user aborting processing. 

A keyword introducing one or more match or halt 
conditions. 



break-reg 



match-cond 



One of the breakpoint registers (BRO, BR1), or BR to set 
both registers to the same match setting. 

One of the following forms of breakpoint register 
settings. 

1. execution-match-condition. (See Execution Match 
Condition in Chapter 6.) 

2. non-execution-match-condition. (See Non-Execution 
Match Condition in Chapter 6.) 



NOTES 

The ICE-86A emulator cannot enter GO or STEP with the 8086 Trap Flag 
(TFL) set. Therefore a warning message will be issued whenever GO or 
STEP commands are executed with TFL =1 , and TFL will be set to 0. The 
Trap Flag is ignored during single step mode and on the first instruction 
step during emulation. 

If either breakpoint register contains a match range other than a single 
match-value and the breakpoint register has changed since the last GO com- 
mand, the message "LOADING RANGE BREAKPOINTS" is issued, and 
it takes approximately 10 seconds to load breakpoints and hardware before 
emulation begins. 

See Breakpoint Restrictions (Chapter 6) for breakpoint interrupt 
restrictions. 
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Execution breakpoints are complicated by the need to trace the 8086 queue 
operations, and thus do not guarantee that execution will be terminated 
immediately after the specified instruction. The ICE emulator may slip past 
the breakpoint instruction and stop at the next instruction. This slippage is 
dependent on the current depth of the queue when the breakpoint instruc- 
tion requires only two clock cycles for execution. Due to the complexity of 
the breakpoints and exact timing uncertanties, the ICE emulator will not 
detect this slip. The user may determine that the slippage has occurred by 
examining the trace data and comparing the next-to-last instructions exe- 
cuted to the potential break conditions. 

Upon normal termination of code execution containing string operations, 
the ICE-86A emulator appears to hang (no prompt) immediately after 
display of CS:IP. It may take up to 40 seconds for the prompt to appear. 
No such hanging occurs when trace collection is disabled. The cause of this 
hanging is connected to the repetitive nature of string operations and the 
size of the trace buffer. The maximum 1021 allowed frames of trace 
information in the trace buffer can easily be surpassed when collecting trace 
information during execution of string instructions. The original opcode 
fetch of the string instruction is beyond the 1021 frames of trace informa- 
tion. Trace collection and CPU operation are out of sync. The trace buffer 
may be full, but there is no trace. This is the normal trace operation for 
string operations. 
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Set GO-Register (GR) Command 
/ 

FOREVER 



GR = 



TILL break-reg ^ D j break-reg J 

[loR D } mafC "- CO ' ,C '] 



TILL match-cond 



Examples: 



GR = FOREVER 

GR = TILL BR1 

GR = TILL BRO OR BR1 

GR = TILL OBJECT IABLE1 

GR = TILL OBJECT POINTER 0123 READ, WRITTEN VALUE 3000 USING OS 

GR Command keyword referring to the GO-register (halting 

conditions for emulation). 



FOREVER 



TILL 



The assignment operator. 

Disables all breakpoint conditions; emulation can be 
stopped only by user aborting processing. 

A keyword introducing one or more match or halt 
conditions. 



break-reg One of the breakpoint registers, BRO or BR1 (or BR to 

denote both breakpoint registers) that is to be enabled. 

match-cond One of the following forms of breakpoint register 

settings: 

1. execution-match-condition. (See Execution Match 
Condition in Chapter 6.) 

2. non-execution-match-condition. (See Non-Execution 
Match Condition in Chapter 6.) 

NOTE 

See Breakpoint Restrictions (Chapter 6) for breakpoint restrictions. 
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STEP Command 

STEP [FROM address) 
Examples: 
STEP 

STEP FROM 1FFFH 
STEP FROM ..MOD .GO 
STEP FROM !PTR 
STEP FROM #123 + 10 

STEP FROM CS:(WORD .X) ;SHORT JUMP INDIRECT THROUGH X 

STEP A command keyword that causes the ICE-86A emulator 

to execute a single step of emulation. 

FROM A function keyword introducing the address where a 

single step of emulation is to be executed. 

address See address. (See Set Breakpoint Register Command in 

Chapter 6.) 

The STEP command causes the ICE-86A emulator to execute one single step of 
emulation. If FROM address is not included in the command, the emulation step is 
executed from the current address. If FROM address is included in the command, 
the value of the address is loaded into the CS and IP and the step is executed from 
this location. 

NOTES 

The STEP command is very useful in repeat loops and macros, (see Chap- 
ter 8) where terminating condition can be given (UNTIL or WHILE) and 
system status and values can be displayed after each step. However, the user 
is cautioned that a hardware reinitialization occurs intermittently with a 
reset timeout when the RESET pin is pulsed during a repeat of the STEP 
command. 

See Breakpoint Restrictions (Chapter 6) for step mode interrupt 
restrictions. 

Trace data does not display byte reads of absolute memory locations 08H 
through OBH following single step execution. Absolute memory locations 
08H through OBH contain the NMI vector for Interrupt 2. During single- 
step mode, which is the execution of single instructions halted via an Inter- 
rupt 2, the ICE-86A emulator accesses locations 08H and 09H to enter and 
exit emulation. The ICE software masks these reads out to conserve space in 
the trace buffer. The software does not distinguish between ICE emulator 
reads and user reads of these locations. As a result, user code reading these 
locations during the single-step mode is also masked out. The instructions 
are executed but do not appear in the trace data. 
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Display Emulation Register Command 

GR 

f ABSOLUTE 1 
break-reg [ BASE [expr] J 

f ABSOLUTE "1 
trace-reg [ BASE[expr] J 

Examples: 

GR 
BR1 

BRO BASE CS 

BRO BASE CS SYMBOLICALLY 

BR BASE 

OFFTRACE 

OFF ABSOLUTE 

ONT BASE DS 

ONTRACE BASE DS SYM 



GR A command keyword that causes the content of the 

GO-register (factors enabled to halt emulation) to be 
displayed. 

break-reg One of the breakpoint register keywords BRO or BR1, to 

obtain a display of the register setting, or the keyword BR 
to cause the display of the settings of both breakpoint 
registers. 

trace-reg One of the tracepoint register keywords ONTRACE or 

OFFTRACE to command the display of the content of 
the designated register. 

ABSOLUTE Display all addresses as 20-bit numbers (this is the 

default). 

BASE Display all addresses in base and displacement format 

(e.g., 0000:1000H). If no expr is given, display with the 
base that was used to set the register. 

expr An integer value that specifies that all addresses are to be 

displayed as their displacement from (expr )* 16. An error 
occurs if an address needs a displacement of less than 0 or 
greater than 65535 from the base (expr ). Typically expr 
will be a segment register name; thus 'BRO BASE CS' 
displays the displacements of the addresses in BRO using 
the current code segment register. If no expr is given, use 
the base that the register was set with. 

NOTE 

Data values are always displayed as 16-bit numbers, masked-constants as 
16-bit or 20-bit strings with Xs (in hexadecimal if possible, or else in 
binary). 



Internal to the ICE-86A emulator, match addresses are stored as 20-bit 
numbers. Thus "GO TILL 20:8 R" breaks whenever 208H is read, even if it 
is read as 10:108H. 
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Set CLOCK Command 



CLOCK = 



| INTERNAL \ 
\ EXTERNAL J 



Examples: 



CLOCK = INTERNAL 
CLOCK = EXTERNAL 



CLOCK This command keyword enables the user to designate the 

type of clock being used in the system: user-provided or 
ICE-provided. 

The assignment operator. 

INTERNAL Designates that an ICE-provided clock is being selected. 

This is necessary whenever the cable is not plugged into 
user system. When clock is set to Internal, the ICE-86A 
emulator is operated in stand-alone mode. The Socket 
Protector should be mounted on user cable in this mode 
of operation. 

EXTERNAL Designates the clock to be user supplied. This is desirable 

whenever the cable is plugged into a user system, with 
user supplied clock. Not specifying CLD = EXT when a 
user clock is available could cause non-synchronization 
of user hardware with the ICE emulator. 

NOTE 

Further information on use of the CLOCK command is provided in 
Appendix G. 



Display CLOCK Command 

CLOCK 
Examples: 
CLOCK 

CLOCK A command keyword that causes the display of the clock 

setting. 
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Set RWTflf E0UT Command 



RWTIMEOUT = 



INFINITE 
expr-10 [ERROR] 
; expr-10 NOERROR 



Examples: 



RWTIMEOUT = INFINITE 
RWTIMEOUT = 500 ERROR 
RWTIMEOUT = 500 
RWTIMEOUT = 1500 NOERROR 



DISABLE RWTIMEOUT 

SET TIMEOUT TO HALT EMULATION WITH REPORT 

HALT EMULATION WITH ERROR REPORT 

SET TIMER BUT DO NOT HALT EMULATION WHEN IT 
TIMES OUT 



RWTIMEOUT 



A command keyword denoting that a command signal 
timeout function is to be set. If not set by the user, the 
RWTIMEOUT is set to its default value of 1000 
microseconds. 



Denotes that the command is a set 
command. 



timeout 



INFINITE 



expr-10 



Sets command signal timeout to "infinite," effectively 
disabling the timeout. 

An integer value that specifies the timeout value in 
microseconds. The integer value must be greater than 0 
and less than 32K, and the default suffix when evaluating 
expr-10 is decimal. The default value is 1000 
(microseconds). 

Specifies that error is to be reported whenever command 
signal times out. This is the default setting. 

Specifies that command signal timeout is not to halt 
emulation. 

NOTES 

Byte, Word, and Port commands respond with DONE timeouts if 
RWTIMEOUT = INFINITE and no user ready occurs for 15 seconds. The 
8086 is still active on the user bus, however, until the RESET HARDWARE 
command is entered. 

Further information on use of the RWTIMEOUT command is provided in 
Appendix G. 



ERROR 



NOERROR 



Display RWTIMEOUT Command 

RWTIMEOUT 

RWTIMEOUT Causes the current setting of the command signal timeout 

to be displayed . 
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ENABLE/DISABLE ROY Command 



I ENABLE | 
\ DISABLE } 



RDY 



ENABLE 



A command keyword denoting that an ICE-86A element 
is to be enabled. 



DISABLE 



A command keyword denoting that an ICE-86A element 
is to be disabled. 



RDY 



A reference keyword specifying the user-ready signal for 
memory access. 



The ICE-86A emulator allows the user to enable and disable the user-ready signal. If 
RDY is enabled, the ready signal to the 8086 is a local ready (generated by the 
ICE-86A emulator) AND user ready; otherwise ready to the 8086 is either the local 
ready when mapped to local memory or user ready when mapped to user memory. 
RDY is initially enabled. 



When emulating in the user memory with DISABLE RDY invoked, the user 
ready pin must be active to continue emulation. Since all I/O Ports are in 
the user system, an access to a port requires a user Ready to continue 
emulation. 

Further information on use of the ENABLE/DISABLE RDY command is 
provided in Appendix G. 



NOTES 
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The ICE-86A emulator can record program execution through the collection of trace 
data in a trace buffer during real-time and single-step emulation. The commands in 
this section allow you to specify the conditions for enabling and disabling trace data 
collection during emulation and to control the display of trace data. 

The commands in this section are as follows: 



COMMAND 

Set TRACE Display Mode 

ENABLE/DISABLE TRACE 
Display TRACE Mode 
MOVE, OLDEST, NEWEST 
PRINT 



PURPOSE 

Establishes trace data that will be displayed as 
frames or instructions. 

Enables or disables the collection of trace data. 
Causes the display of the current display mode. 
Set trace buffer pointer to entry to be displayed. 
Display one or more entries from the trace buffer. 



Discussion 



The unit of 1CE-86A emulation is the instruction. During real-time and single-step 
emulation, the ICE-86A emulator traces program execution twice per 8086 bus 
cycle: first when the address signals are valid and then when the data signals are 
valid. It also traces each CPU clock cycle during which the execution queue is active. 

The IGE-86A emulator contains a trace buffer used to collect trace data (frames) 
during real-time and single-step emulation. The trace buffer holds a total of 1023 
frames or approximately 300 bus cycles of trace information. Each entry in the buf- 
fer is a frame, and is either half a bus cycle or contains queue status, or both. Each 
frame contains: 



bit-size purpose 

20 Address/data 

3 Bus status (SO/, S1/,S2/) 

2 Queue Status (QS0, QS1 ) 

3 Queue depth 

2 Frame type indicator: address, data, or queue status 

1 Start/stop trace marker for conditional trace 

1 Byte High Enable (BHE/) 



Trace is initially unconditionally on and the buffer is initially empty. The buffer is 
cleared whenever the user changes the IP or CS, either by a FROM clause on a GO 
or STEP command or by a Change command. Otherwise new trace data is appended 
to the end of existing trace data and the most recent 1023 frames are retained in the 
buffer. Similarly, the TIMER and HTIMER registers are reset to zero each time the 
user changes the IP or CS register. Also, whenever the user issues an enable/disable 
trace command, the trace buffer is cleared to empty and TIMER and HTIMER are 
reset to zero when the user next enters emulation. 
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The user can control the collection of trace data using the tracepoint registers. The 
enable/ disable trace command enables trace conditionally and unconditionally or 
disables trace unconditionally: 

ENABLE TRACE Turns trace on unconditionally during 

subsequent emulations. 

ENABLE TRACE f" NOW |ON I ~| Trace will be turned on whenever the 
CONDITIONALLY L lOFFi J register matches and turned off whenever 

the OFFTRACE register matches. 

NOW ON indicates that trace is turned on for the beginning of the next emulation; 
NOW OFF indicates it is off; if neither is present the trace is left in its current state. 

DISABLE TRACE Turns trace off unconditionally during 

subsequent emulations. 

The trace display command allows the user to examine collected trace data displayed 
in one of two modes: as "raw" data or disassembled with instructions appearing as 
8086 assembler mnemonics. 

Instructions in the trace buffer are counted by occurrences of queue status indicating 
"first instruction byte out of queue" (i.e., QS0=1 and QS1=0). Since the 8086 
defines instruction prefix bytes as well as the first non-prefix byte as "first instruc- 
tion bytes", an 8086 instruction with one prefix byte counts as two instructions 
when using the MOVE or PRINT commands. However, if a PRINT command 
prints the requested number of instructions and ends up after a prefix byte but 
before the non-prefix instruction, it completes printing the entire non-prefix instruc- 
tion. When the user switches from frames to instructions mode, if the buffer pointer 
is not at the oldest or newest frame, then the pointer is moved to a "first byte out of 
queue" frame if it is not already pointing at one before beginning to MOVE or 
PRINT the requested number of instructions. 

Trace Display Mode 

The trace display mode controls the type of an entry to be displayed or located in the 
trace buffer. An entry can be a frame or an instruction. The initial trace display 
mode is INSTRUCTION. To set the trace display mode, use one of the following 
commands. 

TRACE = FRAME 
TRACE = INSTRUCTION 

To display an entry from the buffer, move the pointer to the desired entry and enter 
a PRINT command. However, it is not necessary to move the pointer if you use a 
PRINT ALL or PRINT -decimal command. 



Moving the Buffer Pointer 

The pointer movement commands are MOVE, OLDEST, and NEWEST. 

The command OLDEST (followed by carriage return) moves the pointer to the top 
of the buffer, in any trace display mode. The NEWEST command moves the pointer 
to the bottom of the buffer (i.e., after the last instruction or frame). "Top" refers to 
the oldest trace data, "bottom" refers to the newest trace data. 

The MOVE command has the following form: 

MOVE [[+::-] decimal] 
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The meta-term decimal means any numeric quantity; if no explicit input-radix is 
given, the 1CE-86A emulator assumes decimal radix. The value of decimal is the 
number of entries between the current pointer position and the desired position. 
Movement in a plus (+) direction is toward the bottom (newest point) of the buffer; 
if neither (+) nor (-) is entered, a f ©reward movement is assumed as the default. 
Movement in a minus (-) direction is toward the top (oldest point) of the buffer. 
The size of the move does not count the entry under the pointer when the MOVE 
command is given. 

For example, assuming FRAME mode, if the pointer is pointing at frame 100 and 
you issue the command 'MOVE 10\ the pointer is moved to point to frame 110. 
Under the same initial conditions, if you issue the command 'MOVE -10\ the 
pointer is moved to point to frame 90. If decimal-number is larger than the number 
of entries between the current pointer location and the bottom (for '+') or top (for 
'-'), the pointer is moved only to the bottom or top, respectively. In short, you 
cannot move the pointer outside the range of buffer locations. 

If the MOVE command has no number following it, 'MOVE V is executed. 

The trace display mode in effect controls the size of each move. Under FRAME 
mode, the command MOVE 10 moves down ten frames; under instruction, the same 
command moves down ten instructions. 



Displaying Trace Data 

The PRINT command displays one or more entries from the buffer. This command 
has the form: 

PRINT [[ + : : -] decimal ]: :PRINT ALL 

With (+) or no sign, decimal entries lower (toward the bottom) than the current 
pointer position are displayed. With (-), decimal entries above (toward the top) the 
current pointer position are displayed. The command PRINT without a decimal 
modifier is equivalent to PRINT 1 (one entry is displayed). 

The PRINT command displays the number of entries requested, then moves the 
pointer to point to the next entry just past the last one displayed. As an illustration, 
the commands: 

OLDEST 
PRINT 10 
PRINT 10 

are equivalent to the commands 

OLDEST 
PRINT 20 

The command PRINT ALL displays the entire trace buffer; PRINT ALL is 
equivalent to the commands: 

OLDEST 
PRINT 1022 



Trace Data Display Restrictions. Trace data does not contain byte reads from 
absolute memory locations 08H through OBH during Single Step Emulation. Reads 
from these locations are masked out of the trace buffer during Single Step Mode 
because, when single-stepping, emulation is halted via Interrupt 2; and absolute 
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locations 08H through OBH contain the NMI Vector for Interrupt 2. Thus, during 
Single Step Emulation, the ICE-86A emulator must access locations 08H through 
OBH to enter and exit emulation. The 1CE-86A software masks any reads from these 
locations so the system data will not take up room in the trace buffer. Consequently, 
user code which reads from these locations will also be masked from the trace buffer 
during Single Step Mode. 



TRACE Display Formats 



Display of Trace Data in Frames Mode 

The display has one frame per line. The header at the top of display has the follow- 
ing format (one line of display shown also): 

FRAME ADDR BHE/ STS QSTS QDEPTH DMUX MARK 
0000: 0002CH 0 F N 0 A 0 

How to interpret the Frames mode display: 

Header en try Meaning 

FRAME Frame number; decimal number from 0000 to 1022. The colon 

separates the frame number from the next entry (ADDR). 

ADDR The 20-bit address in Hexadecimal radix (five digits plus suffix H) 

when DMUX = A (address frame). When DMUX = D (data 
frame), the last 4 digits (16 bits) of this number are data, and the 
first digit is status: S6, S5, S4, S3 (MSB to LSB). Bits S4 and S3 are 
the segment register used in effective address calculation: 



S4 S3 Segment Register 

0 0 ES 

0 1 SS 

1 0 CS or none 
1 1 DS 



BHE/ Not Byte High Enable (displays "0" if high byte enabled, or ' ' 1" if 

not— note reverse logic as on 8086 pin). 

STS A one-character display of processor action, as follows: 



A 


Interrupt Acknowledge 


F 


Instruction Fetch 


H 


Halt 


I 


Input 


O 


Output 


R 


Read (Memory) 


W 


Write (Memory) 


? 


Passive State 



STS is valid on ADDR and DATA frames only (DMUX = A or D). 

QSTS Queue status; a one-character display, as follows: 

E Empty the queue 

F First byte of opcode executed out of queue 

N Nothing coming out of queue 

S Subsequent byte of opcode executed out of queue 
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QDEPTH Number of bytes in queue (decimal number). Valid on ADDR 
frames only (DMUX = A). 

DMUX Type of frame; a one-character display as follows: 

A Address 

D Data 

Q Queue 

S Stop emulation 

MARK Displays a "1" if trace was turned off, then on again just before 

this frame (using tracepoint registers); otherwise displays "0". 



Display of Trace Data in Instructions Mode 

The display shows the disassembled instruction mnemonic and any operands, and 
any succeeding cycles. Each instruction combines several frames of trace data. 
Machine cycles after the instruction fetch are displayed four cycles per display line, 
using as many lines as necessary. 

First, we discuss the header and the instruction display. Display of cycles is discussed 
later on. The headers apply to the first line of the display entry— the line with the 
frame numbers. The Instructions mode header has the following format (two 
instructions are also shown): 



FRAME ADDR PREFIX 
0006: 000E7H 
0010: 000E9H 

00101H-W- 2CH-DS 



MNEMONIC OPERANDS COMMENTS 
DEC CL 

MOV WORD PTR [0101H],BX 

00102H-W- 00H-DS 



Header entry Meaning 



FRAME The (decimal) number of the frame where the first byte (or prefix) 

of the instruction came out of the 8086 execution queue. 

ADDR Address of first byte (or prefix) of instruction; 20-bit number in 

Hexadecimal radix (five Hex digits plus suffix H). 

PREFIX Prefix other than segment-override (LOCK, REPE, REPNE) if 

specified in assembly language, else blank. 

MNEMONIC MCS-86 assembler mnemonic for the instruction. 



OPERANDS Zero, one, or two operands separated by commas. The formats for 
the operand fields are discussed below. 



COMMENTS The word ";SHORT" for a JMP or CALL instruction to an 
address within the same segment of field bytes that contains the 
instruction's address, or the word "jLONG" for a branch to a dif- 
ferent segment, or the characters ";?" for an opcode value that 
does not correspond to a valid instruction. 



Operand Fields 

1 . Registers: the iAPX-86 register identifiers are displayed: 

RAL, RAH, RBL, RBH, RCL, RCH, RDL, RDH, 
RAX, RBX, RCX, RDX 
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Example (comments field omitted): 

FRAME ADDR PREFIX MNEMONIC OPERANDS 
0003: 00206H MOV AL,BYTE PTR [0000H] 

00200H-R- 34H-DS 

Memory operands have the following display format: 





Is) 






BYTE 




> » 


bx] 






» » 


Dl , , 






xxx xx H 








■ 




WORD 


PTR 




bp| 






[ . 


SI ] 




[ . 






[ 








DWORD 


► 












+xxH 












1=1 






? 






1 1 








-xx H 






























V / 











Example: the display ES:BYTE PTR [BX] [SI] [ + 01H] represents the operand 
BYTE ES:(BX + SI+1) 

More examples showing memory operand display. 

FRAME ADDR PREFIX MNEMONIC OPERANDS 

0000: FF380H ADD ES:BYTE PTR [BX] [SI], AL 



0025: 



FF480H 



ADD ES:BYTE PTR [BX] [SI] [ + 01H], AL 
AL, BYTE PTR [0001 H] 



0050: FF580H MOV 
Notes on the memory operand format: 

• The first field is the segment register field. It is only displayed if the 
instruction has a segment-override prefix. 

• In the second field, an entry "? PTR" means that the type of the pointer 
cannot be determined from the context. 

Example: LEA AX,? PTR [34A0H] 

• The base register (BX, BP) and index register (DI, SI) fields are not 
displayed for direct memory operands. When these fields are displayed, 
they are enclosed in brackets (shown as '[' and in the format given 
earlier). 

• The last field is either a 16-bit unsigned (word) number, or a signed 8-bit 
(byte) number. The entry is displayed enclosed in brackets. 

• At least one of the last three fields (base register, index register, number) is 
displayed for any memory operand. 

3. Immediate data is displayed as a byte or word number, without brackets. 
Example: 

FRAME ADDR PREFIX MNEMONIC OPERANDS 
0932: FF391H TEST AL, 07H 

4. Labels for the JUMP and CALL instructions: 

• Within 128 bytes of current address— $ ± xxH 
Example: 

0934: FF393H JE $-06H 

• Within same 64K segment as current address— $ + xxxxH 
Example: 

0000: FF000H JMP S + 1005H 

• To a different segment— base '.displacement 
Example: 

0978: FFFF0H JMP FF00.0096H 

Note: the first two labels represent 6 'SHORT" (intra-segment) branches, the third is 
a 4 'LONG' ' (inter-segment) branch. 
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Display of Cycles in Instruction Mode. After the instruction mnemonic and 
operands are displayed, the display shows succeeding cycles performed by the cur- 
rent instruction. Four cycles are shown per line of display; the display uses as many 
lines as needed to show all cycles. 

The general format for cycles display is: 



address-status-data-segment 

Examples: 

• Read/Write: 

12345H-R- 34H-DS (8-bit read of data 34H from address 12345H using DS) 

45100H-W-7000H-SS (16-bit write of data 7000H to address 45100H using SS) 

• Input/Output: (no segment register; 16-bit address) 

FF00H-I-01H (8-bit input of data 01 H from port FF00H) 
FFDAH-0-1234H (16-bit output of data 1234H to port FFDAH) 

• Interrupt Acknowledge: no address field, "A" for ' 'acknowledge' ' status, 8-bit 
interrupt type. 



Example: 

FRAME ADDR 
0980: FF391H 



PREFIX 



0982: 
0990: 
0996: 



FF393H 



FF390H 
FFEAH-I- 00H 
A- FFH 
A- FFH 

H-SS 

000B8H-W-FF0OH-SS 



MNEMONIC 
TEST 
JE 

FF38DH 
IN 



OPERANDS 

AL,07H 

$-06H 

MOV 

AL.DX 



COMMENTS 

; SHORT 
DX,FFEAH 



003FCH-R-0000H-CS 003FEH-R-FFFFH-CS 000BAH-W-F246 



000B6H-W-0391H-SS 



Note that: 

a. The I cycle is part of the IN instruction; the rest of the cycles are the 
interrupt. 

b. The "A" cycle is traced twice; ignore the first one. 

c. Interrupt is type OFFH 

d. The five cycles after the "A" cycle are as follows: 

— Read IP of interrupt vector 

— Read CS of interrupt vector 

— Write flags to stack 

— Write old CS to stack 

— Write old IP to stack 

• Fetch cycles do not appear as cycles; they are used to display the opcode 
mnemonic and operands. 

• Halt cycles never appear as cycles; they appear as the mnemonic HLT. 



Gaps in Trace in Instruction Mode. In Instruction mode, a gap in trace data is 
shown as three asterisks (***). A gap in trace is produced by tracepoints or by buffer 
overflow. 

A gap in trace data also is reflected by a MARK = 1 in Frames mode. 



6-32 



ICE-86A 



Emulation and Trace Control Commands 



Extended Example of Trace Displays 

The following example (from SDK-86 Monitor) shows most of the features of trace 
displays discussed in this section: 

*ONTRACE=FF00:96 
*OFFTRACE=FFFF:0 
*ONT 

ONT=FF096H A,l,0,H,F,R,W 
*OFFT 

OFFT=FFFF0H A,l,0,H,F,R,W 
*ENABLE TRACE CONDITIONALLY NOW ON 
*GO TILL FF00:9E EXECUTED 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=FF00:00A1H 
*BUF 

BUF=03FDH 
*P-20 



FRAME ADDR 


PREFIX 


MNEMONIC 


OPERANDS 


COMMENTS 


0928: FF390H 




IN 


AL,DX 






FFEAH-I- 


OOH 








0932 


FF391H 




TEST 


AL,07H 




0934 


FF393H 




JE 


$-06H 


; SHORT 


0942 


FF38DH 




MOV 


DX,FFEAH 




0948 


FF390H 




IN 


AL,DX 






FFEAH-I- 


OOH 








0952 


FF391H 




TEST 


AL,07H 




0954 


FF393H 




JE 


$-06H 


; SHORT 


0962 


FF38DH 




MOV 


DX,FFEAH 




0968 


FF390H 




IN 


AL,DX 






FFEAH-I- 


00H 








0972 


FF391H 




TEST 


AL,07H 




0974 


FF393H 




JE 


$-06H 


; SHORT 


0982 


FF38DH 




MOV 


DX,FFEAH 




0988 


FF390H 




IN 


AL,DX 






FFEAH-I- 


00H 








0992: FF39IH 




TEST 


AL,07H 




0994: FF393H 
* * * 




JE 


$-06H 


; SHORT 


1004 


FF098H 




MOV 


SS,WORD PTR [0092H] 




FF092H-R-0007H-CS 








1012: FF09CH 




MOV 


SP,0050H 




1015: FF09FH 




MOV 


BP,SP 




* .TRACE TURNED OFF AT FFFF:0, 


BACK ON AT FF00:96, BREAK AT FF00:9E 



*BR0 



BR0=FF09EH E 
*ONT 

ONT=FF096H A,l,0,H,F,R,W 
*OFFT 

OFFT=FFFF0H A,l,0,H,F,R,W 
*TRA=FRA 



*P-25 



FRAME ADDR 


BHE/ 


STS 


QSTS 


QDEPTH 


DMUX 


MARK 


0996 


BF398H 


0 


? 


E 


0 


Q 


0 


0997 


FFFF0H 


0 


F 


N 


0 


A 


0 


0998 


22EFAH 


0 


F 


N 


2 


D 


1 


0999 


FF098H 


0 


F 


N 


2 


A 


0 


1000 


2168EH 


0 


F 


F 


2 


Q 


0 


1001 


2168EH 


0 


F 


N 


3 


D 


0 


1002 


2168EH 


0 


F 


F 


2 


Q 


0 


1003 


FF09AH 


0 


F 


N 


2 


A 


0 


1004 


20092H 


0 


F 


F 


2 


Q 


0 


1005 


20092H 


0 


F 


S 


2 


D 


0 


1006 


FF09CH 


0 


F 


N 


2 


A 


0 


1007 


250BCH 


0 


F 


S 


2 


Q 


0 


1008 


250BCH 


0 


F 


S 


2 


D 


0 


1009 


FF092H 


0 


R 


N 


2 


A 


0 


1010 


20007H 


0 


R 


N 


2 


D 


0 


1011 


FF09EH 


0 


F 


N 


2 


A 


0 


1012 


28B00H 


0 


F 


F 


3 


D 


0 


1013 


FF0A0H 


0 


F 


S 


2 


A 


0 
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1014 


22EECH 


0 


F 


S 


2 


Q 


0 


1015 


22EECH 


0 


F 


F 


2 


D 


0 


1016 


FF0A2H 


0 


F 


N 


2 


A 


0 


1017 


21E8EH 


0 


F 


S 


2 


Q 


0 


1018 


21E8EH 


0 


F 


N 


3 


D 


0 


1019 


FF0A4H 


0 


F 


N 


3 


A 


0 


1020 


20094H 


0 


F 


N 


5 


D 


0 
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Set TRACE Display Mode Command 

TRACE = | FRAME I 
1 INSTRUCTION J 



Examples: 



TRACE = FRAME 
TRACE = INSTRUCTION 



TRACE 



A command keyword indicating that the mode of display 
for trace data is to be set. 



FRAME 



A function keyword indicating that data in the trace 
buffer is to be displayed frame by frame. 



INSTRUCTION 



A function keyword indicating that data in the trace 
buffer is to be displayed by instruction. Each instruction 
is equivalent to one or more machine cycles. 



In the FRAME mode, trace data is displayed one frame per line, with fields for 
frame number, address/data, bus status, queue status, queue depth, type of frame 
(address, data or queue) and start/stop trace marker. 

In the INSTRUCTION mode, trace is disassembled with instructions appearing as 
8086 assembler mnemonics. All other cycle data other than instruction fetches, the 
address, status and data of the cycle are displayed. Memory fetches into the execu- 
tion queue and queue activity are not shown explicitly. Instead, they are used to find 
the instruction bytes that were executed when the instruction is taken from the 
queue. Whenever it is impossible to disassemble frames, immediately before or after 
a frame with the START/STOP trace marker set, the gap is indicated by a line con- 
taining three asterisks ("***"). in either mode, status appears as "F", "R", "W", 
"I", "O", "H", or "A" corresponding to the match status(es) set in the tracepoint 
register, and addresses are displayed as 20-bit numbers is the displacement of the 
address from that base. 



6-35 



Emulation and Trace Control Commands 



ICE-86A 



EN ABLE/DISABLE TRACE Command 

{ENABLE] f rNOWONll 

DISABLE J TRACE L C0NDIT10NALiY LnOWOFfJJ 

Examples: 

ENABLE TRACE 

ENABLE TRACE CONDITIONALLY 
ENABLE TRACE CONDITIONALLY NOW ON 
ENABLE TRACE CONDITIONALLY NOW OFF 
DISABLE TRACE 



ENABLE A command keyword that causes trace data collection to be 

conditionally or unconditionally enabled. 

DISABLE A command keyword that causes trace data collection to be 

disabled. 



CONDITIONALLY A command modifier that specifies that trace will be turned on 
whenever the ONTRACE register matches and turned off 
whenever the OFFTRACE register matches. 

NOW ON Indicates that trace is turned on for the beginning of the next 

emulation (see Note). 

NOW OFF Indicates that trace is turned off for the beginning of the next 

emulation (see Note). 

TRACE Command modifier denoting that trace is to be 

enabled/disabled. 



NOTES 

If ENABLE TRACE CONDITIONALLY, the tracepoints will inadver- 
tently match and turn trace on or off when entering emulation if the trace- 
point is set to match on a Fetch at address 00008 or 00009, and when exiting 
emulation if the tracepoint is set to match on a Read at address 00008 or 
00009. Conditional trace should not be setup ONTRACE/OFFTRACE 
tracepoints at memory locations 00008 or 00009, as the ICE-86A emulator 
uses these two memory locations when emulation is broken. 



If neither NOW ON or NOW OFF is selected (i.e., ENABLE TRACE 
CONDITIONALLY), trace is left in its current state. 

Upon normal termination of code execution with string operations, the 
ICE-86A emulator appears to hang (no prompt) immediately after display 
of CS:IP. It may take up to 40 seconds for the prompt to appear. No such 
hanging occurs when trace collection is disabled. The cause of this hanging 
is connected to the repetitive nature of string operations and the size of the 
trace buffer. The maximum 1021 allowed frames of trace information in the 
trace buffer can easily be surpassed when collecting trace information dur- 
ing execution of string instructions. The original opcode fetch of the string 
instruction is beyond the 1021 frames of trace information. Trace collection 
and CPU operation are out of sync. The trace buffer may be full, but there 
is no trace. This is the normal trace operation for string operations. 
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Display TRACE Command 

TRACE 
Example: 

TRACE 
TRACE 

A command keyword that, if entered from the keyboard as a 
single token, causes the current TRACE mode (FRA for 
FRAME or INS for INSTRUCTIONS) to be displayed. 

NOTES 

Execution breakpoints are complicated by the need to trace the 8086 queue 
operations, and thus do not guarantee that execution will be terminated 
immediately after the specified instruction. The ICE emulator may slip past 
the breakpoint instruction and stop at the next instruction. This slippage is 
dependent on the current depth of the queue when the breakpoint instruc- 
tion requires only two clock cycles for execution. Due to the complexity of 
the breakpoints and exact timing uncertainties, the ICE emulator will not 
detect this slip. The user may determine that the slippage has occurred by 
examining the trace data and comparing the next-to-last instructions exe- 
cuted to the potential break conditions. 

Trace data does not display byte reads of absolute memory locations 08H 
through OBH following single-step execution. Absolute memory locations 
08H through OBH contain the NMI vector for Interrupt 2. During single- 
step mode, which is the execution of single instructions halted via an Inter- 
rupt 2, the ICE-86 emulator accesses locations 08H and 09H to enter and 
exit emulation. The ICE software masks these reads out to conserve space in 
the trace buffer. The software does not distinguish between ICE emulator 
reads and user reads of these locations. As a result, user code reading these 
locations during the single-step mode is also masked out. The instructions 
are executed but do not appear in the trace data. 
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MOVE, OLDEST, and NEWEST Commands 

MOVE[[ + ::-]decimal] 
OLDEST 
NEWEST 



Example: 

MOVE 
MOVE +6 
MOVE -11 
OLDEST 
NEWEST 



MOVE A command keyword that moves the buffer pointer one 

or more entries forward (toward the most recent entries) 
or backward (toward the earliest entries). An entry is a 
frame or instruction, depending on the TRACE mode in 
effect. 



+ A unary operator specifying a forward movement. Plus is 

the default. 

A unary operator specifying a backward movement. 

decimal A number, evaluated in decimal radix (if no explicit 

suffix is given), that gives the number of entries to be 
included in the MOVE. 

OLDEST A command keyword that moves the pointer to the 

earliest entry in the buffer. 

NEWEST A command keyword that moves the pointer to the latest 

entry in the buffer. 
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PRINT Command 



PRINT 



(ALL | 

( [[ + ''-]decimal] J 



Example: 



PRINT 

PRINT ALL 
PRINT +5 
PRINT 5 
PRINT -10 



PRINT 



A command keyword calling for a display of one or more 
entries from the trace data buffer. The entries are 
displayed as frames or instructions, depending on the 
current trace mode. 



ALL 



A function keyword indicating that the entire trace buffer 
contents are to be displayed. 

A unary operator directing the display of decimal entries 
below (entered later then) the current buffer pointer loca- 
tion. See DISCUSSION for details. Plus is the default. 

A unary operator directing the display of 
decimal-number entries above (entered earlier than) the 
current buffer pointer location. See DISCUSSION for 
details. 



decimal 



A numeric constant, evaluated in decimal suffix, giving 
the number of entries to be displayed. 



6-39 



CHAPTER 7 
INTERROGATION AND 
UTILITY COMMANDS 



Chapter 7 contains discussions, examples, and syntax summaries for each of the 
ICE-86A interrogation and utility commands. 

The following brief outline of Chapter 7 shows how the interrogation and utility 
commands have been clasified. 



Utility Commands Involving ISIS-II 

1CE86 Command 
EXIT Command 
LOAD Command 
SAVE Command 
LIST Command 



Number Bases and Radix Commands 

Set or Display Console Input Radix Commands 
Set or Display Console Output Radix Commands 



Hardware Register Commands 

Set Register Command 
RESET HARDWARE Command 
Set or Display RQ/GT Command 
Display BUS Command 



Memory Mapping Commands 

MAP DISK Command 
MAP INTELLEC Command 
Set MAP Status Command 
Display MAP Status Command 
RESET MAP Command 



Set Memory and Port Content Commands 

Set Memory Command 

Set Input/Output Port Command 



Symbol Table and Statement Number Table Commands 

DEFINE Symbol Command 
Display Symbols Command 
Display Statement Numbers Command 
Display Modules Command 
Change Symbol Command 
REMOVE Symbols Command 
REMOVE Modules Command 
TYPE Command 
Set DOMAIN Command 

ENABLE/DISABLE SYMBOLICALLY Command 
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Display Commands 

Display Processor and Status Registers Command 

Decode CAUSE Command 

Display Memory Command 

Disassembly Command 

Display I/O Command 

Display STACK Command 

Display Boolean Command 

Display NESTING Command 

Evaluate Command 



Utility Commands Involving ISIS-II 

The Intel Systems Implementation Supervisor (ISIS-II) is the diskette operating 
system for the Intellec Microcomputer Development System. The ICE-86A emulator 
runs under ISIS-II control and can call upon ISIS-II for file management function. 

The following commands are included in this section: 



Command Purpose 

ICE86 Load ICE-86A program from diskette. 

EXIT Return control to ISIS-II. 

LOAD Load user program Into memory accessed by the ICE-86A emulator. 

SAVE Copy user program from memory onto diskette. 

LIST Copy ICE-86A emulation output to printer or file. 



Discussion 

ICE-86A commands can use ISIS-II pathnames to direct ISIS-II to a desired disk file 
or other output device. 

For disk files, the format of pathname is as follows. 
:drive:filename 

The entry -.drive: stands for one of the references to ISIS disk drives, in the form: 

:Fn: where n is the drive number from 0-9. 

Refer to the ISIS-II User's Guide for the various configurations allowed for dif- 
ferent kinds of disk drives. 

The entry filename must follow the second colon (after drive) without any interven- 
ing spaces. A filename has the following components. 

identifier [.extension] 

The entry identifier is a name assigned by the user, and is made up of one to six 
alphanumeric characters. The extension is an optional part of the filename, con- 
sisting of one to three alphanumeric characters preceded by a single period. The 
extension must be used if it is present in the directory listing of the file on the 
diskette. If used, the extension follows the identifier without any spaces. Some 
extensions (e.g., .BAK) are assigned by system processors; others can be assigned at 
the desire of the user. An extension provides a second level of file identification; it 
can be used to identify different versions of the same program, or to give sup- 
plemental information about the file (e.g., author, data, version). 
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Fully compiled or assembled programs ready to run (emulate) do not have system- 
assigned extensions, although they may have extensions assigned by the user. 

For devices other than disk files, the format of pathname is as follows: 

idevice: 

The following devices are commonly accessed in ICE-86A commands: 

-.Device: Output Device 

:LP: Line printer 

:HP: High-speed tape punch 

:TO : Teletypewriter printer 

:CO: Console display 

For more information on ISIS-II filenames and device codes, refer to the ISIS-I1 
System User's Guide. 

The 1CE86 command, entered after an ISIS-II prompt, directs ISIS-II to load the 
ICE-86A program from the specified diskette drive into a reserved area in Intellec 
memory. The ICE-86A emulator begins operation as soon as it is loaded, initializing 
its hardware and program variables, and signaling readiness to accept ICE-86A 
commands by displaying an asterisk prompt. 

The EXIT command ends the emulation session and returns control to ISIS-II. The 
command issues a hardware reset before exiting. 

The LOAD command loads the object code from the named file and drive into the 
areas of memory specified by the memory map. Modules are loaded in the order of 
their appearance in the source file. The modules' names, symbols, and statement 
numbers are placed in reserved areas of Intellec memory. Symbols and statement 
numbers are grouped into tables by module in the order in which they appear. Both 
a base value and a displacement value are loaded for all symbols and statement 
numbers. Any symbol that has no type information is given no type specification in 
the symbol table. If no exclude modifiers are included in the command, module 
names are loaded into the ICE-86A module table in the order in which they appear 
following any module names already in the table, symbols and their types (if pre- 
sent) local to each module are loaded into that module's symbol table in the order in 
which they appear, and statement numbers local to each module are loaded into that 
module's statement table (for PL/M 86 programs) in the order in which they appear. 

The command can include one or more modifiers to control what is to be loaded. No 
modifier may be named twice in the same load command. If NOCODE is included, 
the program code is omitted from the load, e.g., it is already in ROM. If NOLINE is 
included, the program statement number table is not loaded. If NOSYMBOL is 
included, the program symbol table is not loaded. Any combination of one, two, or 
three of these modifiers may be included, although the command with all three 
modifiers represents a "null" command. 

NOCODE, NOSYMBOL, and NOLINE can be followed by the SELECTING 
modifier. The SELECTING modifier is intended to aid those users who are unable 
to fit their entire symbol table in memory. The user is allowed to specify which 
modules' symbols are to be loaded. The SELECTING keyword must be followed by 
a module-name, one or more module-ranges {module-name TO module-name), or 
one or more module-ranges followed by a module-name. When a module-name is 
given, the ICE-86A emulator begins loading symbol information (symbol names, 
addresses, and type specifications) when it reads from this module, and continues 
until end of file. When a module range is given, the ICE-86A emulator begins 
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loading symbol information when it reads from the first module in the range, and 
continues through the last module in the range. A warning is issued if the ICE-86A 
emulator reads an end -of file before encountering the end of a range. The 
SELECTING modifier does not affect the loading of object code. 

The SAVE command copies the user program currently loaded from memory onto 
the specified file and drive. If the diskette installed on the given drive does not have 
the named file in its directory, ISIS-II creates the file and opens it for write. If the 
named file does exist on the diskette, the file is overwritten and the previous contents 
are lost. If no explicit drive number is given, drive 0 is assumed. 

The command can include one or more modifiers to control what is to be saved. If 
NOSYMBOL is included, the symbol table is not copied from memory to diskette. If 
NOLINE is included, the statement number table (for PL/M-86 programs) is not 
saved. The modifiers NOCODE and partition are mutually exclusive: if one is used, 
the other may not be included. If NOCODE is included, the program object code is 
not copied to diskette. If partitions are included, only the code stored in the memory 
addresses in the partitions (ranges of addresses) are saved. If neither NOCODE nor 
Partition appears in the command, any code between the lower and highest 
addresses in each IK segment that has been previously loaded is saved. If no code 
has been loaded, no code is saved. When more than one modifier is used, separate 
them with spaces. No modifier may be used twice in the same SAVE command. The 
SAVE operation does not alter the program code, symbol table, or statement 
number table in memory. 

The LIST command saves a record of the emulation session, including high-volume 
data such as trace data, on a hard-copy device or on a diskette file in addition to 
sending it to the console. Only one device or file other than the console can be 
specified (active) at a given time. 

The initial device is :CO:, output to the console. Other devices that can be specified 
are a line printer (:LP:), high-speed paper tape punch (:HP:), and teletypewriter 
printer (:TO:). 

Instead of a hard-copy device, a diskette file can be specified. If the output is to a 
diskette file, the file is opened when the LIST command is invoked, and output is 
stored from the beginning of the file, writing over any existing data. Specifying a 
new file or device in a later LIST command closes any existing open file and avoids 
over-writing any more data. Specifying the same file in a later LIST causes the delete 
of the file and starting over. 

When LIST is in effect (with a device or file other than :CO:), all output from the 
ICE-86A emulator, including system prompts, commands, and error messages, is 
sent both to the named device or file and to the console display. To restore output to 
the console only (no other device), use the command LIST :CO:. 
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ICE86 Command 



[-.drive] ICE86 [WORKFILES(:a/f. drive:)] 
Example: 



:F1:ICE86 

:F1 ICE86 WORKFILES(:F2:) 



'.drive: 



The number of the diskette drive containing the ICE-86A software 
diskette. The number is preceded by the letter F and enclosed in 
colons. This drive is also the default drive for the ICE temporary 
workfile. 



ICE86 



The name of the ICE-86A program file under ISIS-II. The filename 
follows the second colon without any intervening spaces. 



WORKFILES Control keyword specifying that an alternate disk drive is to be 
used for the ICE temporary workfile. 

\alt drive: The number of the diskette drive containing the diskette where the 

temporary workfile is to be stored. The number is preceded by the 
letter F and enclosed in colons. 



NOTE 

Inspect the diskette containing the ICE-86A program prior to loading into 
the diskette drive. If the WORKFILES control is specified, the diskette con- 
taining the ICE-86A program may be write protected. If the WORKFILES 
control is not specified, the diskette containing the ICE-86A program must 
not be write protected or an ISIS ERR24 (write protect) will result. Ensure 
that the diskette has a write-enable tab covering the write protect slot on the 
square plastic diskette housing. 
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EXIT Command 

EXIT 
Example: 
EXIT 

EXIT A command keyword that returns control from the ICE-86A 

emulator to ISIS-II. The command issues a hardware reset before 
exiting, and leaves the file used for DISK-mapped memory intact. 
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LOAD Command 



LOAD[:dr/Ve : ]filename 



NOCODE 

NOSYMBOL 

NOLINE 



...[SELECTING module-partition [, module-partition]. 



module-partition = I module-name 

I module-name TO module-name 



Examples: 

LOAD :F0:TEST.VR1 

LOAD :F1:MYPROG NOLINE 

LOAD :F2:COUNT. ONE NOCODE NOLINE 

LOAD :F3:NEWCOD NOSYMBOL 

LOAD :FO:TEST.VRI SELECTING ONE TO FIVE, SEVEN 

LOAD A command keyword that loads the software on the given file and 

drive into the combination of prototype and Intellec memory 
specified by a previous MAP command. 

.drive: The diskette drive (:F0:, :F1 :, :F2:, or :F3:) that contains the target 

file. If no drive is given, :F0: (drive 0) is the default. 

filename The name of the desired program as compiled or assembled, linked, 

and located. The filename follows the second colon with no 
intervening spaces. 

NOCODE A modifier specifying that program code is not to be loaded. 

NOSYMBOL A modifier specifying that the program symbol table is not to be 
loaded. 

NOLINE A modifier specifying that the program line number table (for 

PL/M-86 programs) is not to be loaded. 

SELECTING A modifier that denotes that a range of modules whose symbols are 
to be loaded is to follow. 



module-name A sequence of continuous alphanumeric characters that references 
a program module. 

TO A connector that denotes that a module name is to follow that 

defines the end of a range of modules. 

NOTE 

In this command, module-name is not preceded by two periods as it is in 
other cases. 

When compiling, linking and locating PL/M-86 programs on a Series III 
8086 based development system (as opposed to running under ISIS-II on an 
8085) the NOIC option must be used on the LOCATE command line. 
Otherwise, the LOCATE program produces a block of initialization code 
which is understood by the Series III monitor but not by the ICE-86A 
emulator. This initialization code will prevent ICE-86A from LOADing the 
program. 
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SAVE Command 



SAVE ['.drive \}filename 



NOCODE 
NOSYMBOL 
NO LINE 



[partition [ partition ]] 



Examples: 



SAVE :F1:TEST 

SAVE :F0:MYPROG 0800 TO OFFF NO LINE 

SAVE :F2:COUNT.TWO NO LINE NOSYMBOL 

SAVE :F3:NEWSYM NOCODE NOLINE 

SAVE : FT: TEST #1 TO #50,..SUBR #1 TO ..SUBR #20 



SAVE The command keyword that directs the ICE-86A emulator to write 

the designated software elements to the indicated file and drive. 

-.drive: The diskette drive (:F0:, :F1 :, :F2:, :F3:> holding the diskette that is 

to contain the saved software. If no explicit drive number is given, 
drive 0 is the default. 



filename The name of the file that is to receive the saved information. The 

name of the file, including the extension if present, must follow the 
rules for naming files under ISIS-II. The filename immediately 
follows the second colon. If the filename does not exist on the 
designated diskette, ISIS-II creates the file and opens it for write. If 
it does exist, the current file is destroyed. 

NOCODE A modifier specifying that program code is not to be saved. 

partition A construct specifying a range of one or more contiguous locations 

in memory; the contents of the specified locations are saved, but 
code in other locations is not copied. 



NOSYMBOL A modifier specifying that the symbol table is not to be saved to 
diskette. 

NOLINE A modifier specifying that the line number table (for PL/M-86 

programs) is not to be saved. 



7-8 



ICE-86A 



Interrogation and Utility Commands 



LIST Command 

LIST | -.device: \ 
| [:drive:]fHename I 

Examples: 

LIST :LP: 
LIST :CO: 
LIST :F1:ICEFIL 

LIST The command keyword directing all ICE-86A output to be sent to 

the specified device or file, and to the console. 

•.device: An IS1S-II device code, indicating a hard-copy output device to 

receive the output. 

•.drive: The diskette drive holding the diskette on which output is to be 

written. If no explicit drive is given, drive 0 is assumed. 

filename The name of the file on the target diskette. The filename 

immediately follows the second colon without intervening spaces. 
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Number Bases and Radix Commands 

ICE-86A commands and displays involve several different number bases (radixes). 
This section describes the various radixes used by the ICE-86A emulator and the 
commands used to control some of them. Most radixes are set by the ICE-86A 
emulator and cannot be changed, but others are under your control: 

This section gives details on the following commands: 

Command Purpose 

SUFFIX Set or display console input radix. 

BASE Set or display console output radix. 



Discussion 

The commands given in detail in this section refer to the radixes used for console 
input and console output. 



Console Input Radixes: SUFFIX Command 

Any number entered from the console can include an explicit input radix. An 
explicit input radix consists of one of the following alphabet characters appended 
directly to the number as entered. 



Explicit 


Example 


Radix Specified 


Radix 






Y 


1001Y 


Binary (base 2) 


Q,0 


11Q 


Octal (base 8) 


T 


9T 


Decimal (base 10) 


H 


9H 


Hexadecimal (base 16) 


K 


3K 


Multiple of 1024 decimal 



The implicit input radix is the base used by the ICE-86A emulator to interpret 
numbers entered from the console without an explicit radix. 

To display the current implicit input radix, enter the command token SUFFIX 
followed by a carriage return. The implicit input radix can be Y, Q, O, T, or H, as 
defined earlier. The initial implicit radix is hexadecimal. 

You can change the implicit input radix by entering a command with the form 
SUFFIX = suffix , where suffix is any of the characters Y, Q, T, or H. This 
SUFFIX command can be used where several numbers are to be entered in the same 
radix. 

Note that K (multiple of 1024) cannot be specified as an explicit input radix. 

For some kinds of entries from the console, the implicit input radix is always 
decimal (T). Entries with implicit decimal radix afe: 

• Numbers entered after MOVE and PRINT keywords. 

• Program statement numbers. 

• Value in COUNT command. 

• Timeout value in RWTIMEOUT 

• Segment numbers in MAP. 
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An explicit radix always takes precedence over the implicit radix. If the digits in the 
number entered cannot be interpreted in either the explicit or the implicit radix, an 
error message is displayed. 

Console Output Radixes: BASE Command 

Numeric information, such as memory and register contents, and data, is displayed 
in the current console output radix. The console output radix can be one of the 
following. 



The initial output radix is hexadecimal (H). 

To display the current console output radix, enter the command token BASE 
followed by carriage return. The display consists of a single character, Y, Q, O, T, 
H, or A (for ASCII). 

You can change the console output radix by entering a command with the form 
BASE = base, where base is one of the single characters Y, Q, O, T, or H, or the 
token ASCII. Once the radix is set with a BASE command, it stays in effect until 
another BASE command is entered. 



Output 
Radix 



Radix Specified 



Y 
Q,0 
T 
H 

ASCII 



Binary 
Octal 
Decimal 
Hexadecimal 

ASCII character for each byte 
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Set or Display Console Input Radix Commands 

SUFFIX 

SUFFIX = Y::Q::0::T::H 
Examples: 
SUFFIX . 
SUFFIX = Y 

SUFFIX A command keyword referring to the implicit console input radix. 

The token SUFFIX alone displays the current setting (Y, Q, T, or 
H). 

The assignment operator, indicating that the new setting is to 
follow. 

Y Binary radix. 

Q,0 Octal radix. 

T Decimal radix. 

H Hexadecimal radix. 
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Set or Display Console Output Radix Commands 



BASE 

BASE = Y::Q::0::T::H::ASCII 
Examples: 

BASE 

BASE = Q 
BASE 



Y 

Q,0 

T 

H 

ASCII 



A command keyword referring to the system console output radix. 
The token BASE alone displays the current setting (Y, Q, T, H, 
or A). 

The assignment operator, indicating that the new setting is to 
follow. 

Binary radix. 

Octal radix. 

Decimal radix. 

Hexadecimal radix. 

Each byte represented by its corresponding ASCII character, 
without separators. 
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Hardware Register Commands 

This section presents the keywords used in the ICE-86A emulator to refer to the 
following types of hardware registers and signals. 

• 8086 Processor Register 

• 8086 Status Flags 

• ICE-86A Status Registers 

• 8086 Pin Signals 

The following commands that refer to hardware registers and signals are discussed 
in this section: 



Command 

Set Register 

RESET HARDWARE 
Set or Display RQGT 

Display BUS Command 

Discussion 



Purpose 

Set (change) the contents of any of the writeable 8086 
registers. 

Reset ICE-86A hardware to initial state. 

Specifies whether Request/Grant lines operate continuously 
or only during emulation time. 

Displays current master of the system bus. 



Tables 7-1 through 7-6 show the tokens used to refer to any 8086 8-bit register, 16-bit 
register, or pin signal. 



Meta-term 

general-register 

pointer-register 

index-register 

segment-register 

status-register 

pin-reference 

flag-reference 



Class of tokens 

16-bit and 8-bit work registers 

16-bit pointer registers 

16-bit index registers 

16-bit segment reference registers 

8- and 16-bit status registers 

8086 pin signals 

8086 status flags 

Table 7- 1 . 8086 General Registers 



reference 


8086 Register and Interpretation 


RAX 


16-bit Accumulator 


RAH 


High 8 bits of Accumulator 


RAL 


Low 8 bits of Accumulator 


RBX 


16-bit Base Register 


RBH 


High 8 bits of Base Register 


RBL 


Low 8 bits of Base Register 


RCX 


16-bit Count Register 


RCH 


High 8 bits of Count Register 


RCL 


Low 8 bits of Count Register 


RDX 


16-bit Data Register 


RDH 


High 8 bits of Data Register 


RDL 


Low 8 bits of Data Register 
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Table 7-2. Pointer Registers 



reference 


8086 Register and Interpretation 


SP 


16-bit Stack Pointer 


BP 


16-bit Base Pointer 


Table 7-3. Index Registers 


reference 


8086 Register and Interpretation 


SI 


16-bit Source Index 


Dl 


16-bit Destination Register 


Table 7-4. Segment Registers 


reference 


8086 Register and Interpretation 


CS 


16-bit Code Segment Register 


DS 


16-bit Data Segment Register 


SS 


16-bit Stack Segment Register 


ES 


16-bit Extra Segment Register 


Table 7-5. Status Registers 


reference 


Register and Interpretation 


IP 


16-bit Instruction Pointer Register 


RF 


16-bit Flag Register 


CAUSE (Read only) 


8-bit Cause of last break in emulation 


OPCODE (Read only) 


8-bit Previous opcode executed 


PIP (Read only) 


16-bit Previous Instruction Pointer Register 


TIMER (Read only) 


Low 16 bits of emulation timer 


HTIMER (Read only) 


High 16 bit of emulation timer 


BUFFERSIZE (Read only) 


16-bit trace buffer size Register 
(Displayed in decimal only) 


UPPER (Read only) 


Highest available address in ICE-86A 
workspace 


LOWER (Read only) 


Lowest available address in ICE-86A 
workspace 
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Table 7-6 . Pin References 



reference 


8086 Pin (Read only) 


RDY 




READY 


NMI 




NMI 


1 bo 1 




TEST 


HOLD 




HOLD 


RST 




RESET 


MN 

• 




MN/MX (minimum /maximum configuration) 


IR 




INTR 


RQGT, BUS 




RQ/GTO, RQ/GT1 (HOLD, HLDA) 


Table 7-7 Flag References 


reference 


Flag 


AFL 




Auxiliary-carry out of low byte to high byte 


CFL 




Carry or borrow out of high byte 


DFL 




Direction of string manipulation instruction 


IFL 




Interrupt-enable (external) 


OFL 




Overflow flag in signed arithmetic 


PFL 




Parity 


SFL 




Sign of the result of an operation 


TFL 




Trap used to place processor in single step 
mode for debug 


ZFL 




Zero indicates a zero value result of an 
operation 


To set (change) the content of one of the processor registers, use a command with 
the form: 


reference = expr 







Where expr is a numerical constant or numerical expression giving the desired new 
contents. Each of the registers that can be changed with this command has a definite 
size (16, 8, or 1 bits). If the new contents represents fewer bits than the destination 
register, the bits are right-justified in the register, and the remaining bits are set to 
zero. In other words the ICE-86A emulator assumes that the quantity represents the 
lowest-order bits, and sets any unspecified high-order bits to zero. 

The RESET HARDWARE command is used to restore the ICE-86A hardware to 
the initial program load condition. One use for this command might be to reset the 
hardware when reconfiguring. The EXIT command includes the RESET 
HARDWARE function. 
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When a RESET HARDWARE command is issued, the 1CE-86A emulator attempts 
to reset the hardware without disturbing any internal controls or user-specified setup 
(breakpoints, map, or enable/disable trace conditionally). If this attempt is suc- 
cessful, the 1CE-86A emulator returns a prompt to the user immediately: 

XLOCK = INTERNAL 

*RESET HARDWARE ;This reset will not encounter any problems. 

; Prompt appears immediately, no internal 
; setup affected. 

The user may now continue his processing. 

If, however, this attempt is unsuccessful, the ICE-86A emulator will warn the user 
that it is beginning to reinitialize the hardware. It then attempts to reset the hard- 
ware by using initialization procedures and then restoring internal controls and 
setup to the pre-reset state (trace, however, cannot be restored to its previous state, 
and will be enabled unconditionally). Although no internal registers or flags are 
changed, the integrity of user memory, ICE memory, and current disk-mapped 
memory cannot be guaranteed. If this attempt to reset the hardware is successful, 
the ICE-86A emulator will return a warning to the user that the hardware has been 
initialized followed by a prompt. The user may then examine memory for integrity, 
reload memory or continue processing. 

NOTE 

If the above reinitialization is successful, the ICE-86A emulator may 
require up to approximately 30 seconds to fully restore the map. 

If the ICE-86A emulator detects an error during this attempt, it will return an error 
message and a prompt to the user. No warning that the hardware has been 
reinitialized will be returned/The user should attempt to resolve the error condition 
and MUST reissue the RESET HARDWARE command. The ICE-86A emulator 
will then go through the reinitialization as described above. The following example 
illustrates the procedures required to respond to error conditions: 

*CLOCK = EXTERNAL ;This command forces an error condition. 

ERR 40:NO USER CLOCK ;Error response. 

* RESET HARDWARE ;Not able to reset, tries to reinitialize. 
WARN C8:REINITIALIZING - FAULT 

ERR 40:NO USER CLOCK ;Reports an error and no warning that hardware 

;was reinitialized; thus, reinitialization was not 
;able to complete. The user must clear the 
;error condition and then reset the hardware 
;again in order to get the hardware into a 

*CLO = INT ;known state. Clears the error condition, must 

* RESET HARDWARE ;reset again. This reset must clear the 

;incomplete reset from above. 

WARN C8:REINITIALIZING - FAULT 

WARN C6:HARDWARE REINITIALIZED ;Note that the user is informed that the 

;hardware has been reinitialized and that the 
;user specified setup (map, breakpoints, etc.) 
;has been restored. Memory contents (ICE 
;memory, user memory, and current disk- 
;mapped memory) cannot be guaranteed. The 

* ;user must verify the contents or reload his 

* ;code and data. 



WARNING 



The RESET HARDWARE signal pulse may be cut short by an emulation 
halt, with undefined results. The reset pulse should be a minimum of four 
clock cycles in duration. If an emulation begins or stops while the reset 
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signal level is being changed, there is no guarantee to the user as to the 
validity of the register contents or flags. RESET HARDWARE signal 
pulses are not saved when an emulation halt occurs, and are not resyn- 
chronized when emulation recontinues. Frequent emulation halts in con- 
junction with Reset Pin level changes, of course, will heighten the chance of 
entering this undefined state, and should be avoided. (There is a four clock 
cycle window while entering or exiting emulation during which the Reset 
Pin should be stable to assure predictable behavior.) 

The 1NITOUT/ line on the ICE-86A buffer box is activated by the RESET 
HARDWARE command. This signal (active low) can be used to reset user hardware 
working with the 8086 such as the 8087 NDP or the 8089 IOP. See the section on 
* 'Buffer Box Signals" in Chapters 1 and 2 for more information. 

The 8086 processor can operate in minimum or maximum mode. In minimum mode, 
requests for the bus are made through the HOLD and HLDA lines. In maximum 
mode, these lines are relabeled RQ/GTO and RQ/GT1, respectively (referred to 
together as the "Request/Grant lines"), and are used to support coprocessor 
requests for the bus. 

Typical applications of the Request/Grant lines would be expansion of the 8086 pro- 
cessor's arithmetic abilities to include floating point calculations by sharing the bus 
with an 8087 Numeric Data Processor, or providing more efficient handling of I/O 
by sharing the bus with an 8089 Input/Output Processor. See The 8086 Family 
User's Manual Numerics Supplement, Manual Order Number 121586, for material 
on the use of the 8087 NDP as a coprocessor. The RBF-89 Real-Time Breakpoint 
Facility is a software superset of the ICE-86 emulator that aids in designing applica- 
tion systems based on an 8086 CPU used in combination with an 8089 IOP. See the 
8089 Real-Time Breakpoint Facility Operating Instructions, Manual Order Number 
162490, for material on this facility.) 

NOTE 

The request/grant operation is a three-phase sequence. First, the 
coprocessor desiring the bus pulses a request/grant line, either RQ/GTO or 
RQ/GT1. Second, the 8086 CPU returns a pulse on the same line indicating 
that it is relinquishing the bus to the querying device. Third, when the 
coprocessor has finished with the bus, it sends a pulse to the 8086 CPU 
indicating that it may resume control. For the physical 8086 processor, 
these signals are recognized 85 ns. into their clock cycles; for the emulated 
8086 processor (that is, the ICE-86A module), however, these signals are 
recognized after 100 ns. 

The Set RQGT Command allows the user to specify whether the Request/Grant 
lines operate continuously in maximum mode or only when the ICE-86A emulator is 
performing emulation. The syntax of the command is 

RQGT = CONTINUOUS 

EMULATIONTIME 

If RQGT is set to CONTINUOUS, then the ICE-86A emulator can respond to bus 
requests from coprocessors whether in Emualation mode or Interrogation and 
Utility mode. If RQGT is set to EMULATIONTIME, then the emulator will not 
respond to bus requests unless it is in Emulation mode. Pending requests are 
remembered and granted when the ICE-86A emulator next performs emulation. 
Initially, RQGT is set to EMULATIONTIME. 

NOTE 

The ICE-86 A emulator's response to bus requests is delayed by 
one clock cycle, whether RQGT is set to CONTINUOUS or 
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EMULATIONTIME. There will always be a minimum of one clock cycle 
between the Request and Grant signals for the emulator, whereas the 8086 
processor alone could drive the signals back to back. This can be critical to 
user's design. Also, the ICE-86A emulator tristates (surrenders the bus) one 
cycle earlier than the 8086 processor, thereby reducing the possibilty of bus 
contention. 

When in minimum configuration, the HOLD and HLDA lines are always enabled. 
That is, they are capable of receiving and responding to requests for the bus whether 
the 1CE-86A emulator is in Emulation or Interrogation and Utility mode. 

The user can display the state of RQGT by typing that keyword. The user can also 
display the current holder of the bus by typing the command BUS. The system will 
respond by displaying the characters 'BUS=8086,' 'BUS=HLDA,' or 'BUS=CH 0' 
or *BUS=CH 1,' which correspond, respectively, to either the 8086 processor con- 
trolling the system bus, the device connected to the HOLD line controlling the 
system bus (only in minimum mode), or one of the devices on either of the 
Request/Grant channels controlling the system bus (only in maximum mode). 



WARNING 



The physical 8086 interrupt acknowledge sequence consists, in part, of two 
INTA bus cycles separated by two idle clock cycles; the address/data bus 
floats from Tl of the first bus cycle until T2 of the second bus cycle. The 
emulated 8086 CPU— that is, the ICE-86A module— does not precisely 
follow this sequence. The address/data bus is active for 20 to 30 
nanoseconds at approximately the end of the first bus cycle and the start of 
the second bus cycle. Therefore, the operator should avoid trying to access 
the address/data bus with any other device during this time period. 

Due to the capacitive loading factor on the RQGT pin, a load exceeding 15 
picofarad cannot be placed on the pin, i.e., no more than one logic probe 
can be placed on the pin. If a problem is detected with the RQGT pin in 
local mode (using an 8087), a 3k ohm pull-up resistor should be put on the 
RQGT line to solve the problem. 
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Set Register Command 

reference = contents 

Examples: 

RAX = 0000H 
IP = F23AH 
IP = !P + 1 
RDL = FFH 
CS = WORD .SAM 



reference The keyword name of any of the writable registers, as follows: 

general registers (see Table 7-1). 
pointer registers (see Table 7-2). 
index registers (see Table 7-3). 
segment registers (see Table 7-4). 
status registers (see Table 7-5). 

The assignment operator. 



contents A numeric expression . 
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RESET HARDWARE Command 

RESET HARDWARE 
Example: 

RESET HARDWARE 

RESET A command keyword restoring its object to a reset condition. 

HARDWARE A function keyword restoring ICE-S6A hardware to the reset 
condition that occurs after the initial 1CE-86A invocation. 

NOTE 

The 1N1TOUT/ line on the 1CE-86A buffer box is activated by the RESET 
HARDWARE command. This line can be used to reset user hardware 
working with the 8086, such as the 8087 NDP or the 8089 IOP. See the sec- 
tion on "Buffer Box Signals" in Chapters 1 and 2 for more information. 
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Set or Display RQGT Command 

RQGT = ["J CONTINUOUS |1 
|_ { EMULATIONTIME J J 

Examples: 
RQGT 

RQGT = EMULATIONTIME 
RQGT = CONTINUOUS 
RQGT 

RQGT = CONTINUOUS 

RQGT A command keyword indicating that the method of handling 

requests for the bus in maximum mode is to be displayed or set. 

The assignment operator. 

CONTINUOUS Requests for the bus in maximum mode are responded to 
whether or not the ICE-86A emulator is in Emulation mode. 

EMULATIONTIME Requests for the bus in maximum mode are responded to only 
when the ICE-86A emulator is in Emulation mode. 
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Display BUS Command 

BUS 
Examples: 
BUS 

BUS=8086 

BUS A command keyword indicating that the current master of the 

bus is to be displayed. 
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Memory Mapping Commands 



The commands in this section control ICE-86A memory map. The ICE-86A 
emulator uses the map to identify what user memory is installed and what types and 
sizes of memory are being "borrowed" from the ICE-86A emulator for testing 
purposes. 

This section gives details on the following commands. 



Command 

MAP DISK 
MAP INTELLEC 

Set MAP Status 

Display MAP Status 
RESET MAP 



Purpose 

Declare which disk file is available for mapping to. 

Declare which physical Intellec segments are available for 
mapping memory to. 

Assign up to 1024 1K segments of memory locations to USER, 
ICE, INTELLEC, DISK, or GUARDED status. 

Display status of one or more memory segments. 

Restore the memory map to its initial condition, all 
GUARDED. 



Discussion 

A maximum of 1M byte (megabyte or 1,04.8,576 bytes) locations are accessible with 
the 20-bit addressing scheme used by the 8086 processor. The MAP commands allow 
this 1M logical address space to be mapped in IK-byte segments (on IK boundaries) 
to any of five locations: (1) physical memory in the user's system, (2) either of two 
IK-byte segments of ICE-86A "real-time" memory, (3) a random-access disk file, 
(4) any IK-byte segment in expansion Intellec memory (addresses at 64K or above), 
or (5) as guarded (i.e., the logical addresses do not physically exist). 

The ICE-86A module supplies 2K bytes of high-speed static memory which may be 
mapped for "real-time" execution. The speed of this memory will allow near real- 
time operation. The 2K bytes may be mapped in IK-byte segments into appropriate 
address space within the 8086's lM-byte address space. 

Disk-based memory and expansion Intellec memory both provide substantially 
slower execution speeds since all accesses to these memories are processed by the 
ICE-86A processor. The first 64K of Intellec memory is reserved for system and 
ICE-86A software. Therefore, any memory assigned to the user must reside in 
expansion Intellec memory above 64K. 

The MAP commands are used to declare, set, display, and reset the ICE-86A 
memory mapping. The ICE-86A emulator has 1M logical addresses divided into 
1024 logical address segments, each starting on a IK boundary and representing IK 
bytes of memory. Each segment is addressed by a decimal segment number, n. The 
value of n is an integer value between 0 and 1023. For any given segment n, that seg- 
ment contains addresses nK through nK + 1023. For example, the lowest logical seg- 
ment in memory space contains addresses 0 through 1023 (OK through OK + 1023). 
In a like manner, logical segment 10 would contain addresses 10240 through 11263 
(10K through 10K + 1023). All partitions used in MAP commands must contain seg- 
ment numbers whose values lie between 0 and 1023. 



7-24 



ICE-86A 



Interrogation and Utility Commands 



If the diskette is to be used for user memory, the MAP DISK command must be used 
to declare the disk file to be used. The syntax of the MAP DISK command is: 



MAP DISK = [-.drive:] filename 



The command opens the ISIS-II file specified by filename, checks how many 
physical segments will fit on the diskette, and reports this number to you. MAP 
DISK may only be declared initially and once following each RESET MAP 
command. 



If lntellec memory is to be used for user memory, the MAP INTELLEC command 
must be used to specify the physical memory segments in extended lntellec memory 
to be used by user programs. The syntax of the MAP INTELLEC command is: 



MAP INTELLEC = partition I partition ]... 



where partition is defined as: 

Iphysical-segment-number [TO physical-segment-number] ) 
' ' [physical-segment-number LENGTH physical-segment-length j 

This command declares physical memory segments in expanded lntellec memory 
and checks that the memory physically exists by writing to it and reading back. An 
error occurs if any partitions extend below 64K, as extended lntellec memory exists 
only at addresses 64K or above. Therefore the range of physical-segment-number 
values is 64-1023 (inclusive), the range of physical-segment-length values is 1-960 
(inclusive). A warning is issued if the memory does not exist. INTELLEC declara- 
tions are cumulative between RESET MAP commands. Logical memory segments 
may not be set to the lntellec system or disk until the associated MAP INTELLEC 
or MAP DISK commands have been entered. 

NOTE 

When mapping to lntellec memory on the Model-800 or the Model 22x with 
the 1001 194 IPB, the monitor prom circuitry does not decode the four high 
order bits of a 20-bit address. Therefore, addresses of the 20-bit form 
XXXX 1111 1XXX XXXX XXXX (where X is don't care) will be over- 
shadowed by the monitor and should not be used as addresses to be 
mapped. This does not occur on the Model-225 with the IPC or on the 
Model-22x with the 1002321 IPB. 



The Set MAP Status command is then used to map logical memory segments to 
physical segments. The syntax of the Set MAP Status command is: 



MAP partition =< 



GUARDED 
USER [NOVERIFY] 

ICE {physical-segment-number] [NOVERIFY] 
INTELLEC \physical-segment-number] [NOVERIFY] 
DISK physical-segment-number [NOVERIFY] 



where 



_ | logical-segment-number [TO logical-segment-number] 1 
[ logical-segment-number LENGTH logical-segment-length j 

The Set MAP Status command sets the memory map by assigning logical segments 
to physical addresses in memory: 

USER The logical segments specified are set to exist in the user's memory 

at the same physical addresses as those specified in the logical 
segments. 
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ICE The logical segments specified are set to exist in ICE-86A 

"real-time" memory. The partition specified may only contain a 
maximum of two segments and the physical-segment-number value 
must be 0 or 1 , if one is given. 

INTELLEC The logical segments specified in the partition are set to exist in 
extended Intellec memory starting in the physical segment specified 
by the physical-segment-number in the command, if one is given. 

DISK The logical segments specified in the partition are set to exist on the 

disk file starting at the physical segment specified by the physical- 
segment-number in the command, if one is given. 

GUARDED All accesses to memory addresses in the segments specified by the 
input parameter, partition are error conditions. All memory is 
initially GUARDED. 

NOVERIFY Specifies that write-verification will not be performed when using 
the ICE-86A CHANGE command to change the contents of 
memory. This is useful when memory-mapped I/O is being used. 
Whenever a logical memory segment is mapped USER, ICE, 
INTELLEC, or DISK, it is write-verified unless explicitly 
NOVERIFY. 



When mapping to ICE memory, INTELLEC memory, or DISK memory, if a 
physical-segment-number is given in the command, the first logical segment 
specified in the partition is set to the physical segment specified by the physical- 
segment-number and subsequent logical segments are set at subsequent physical 
segments. If more logical segments are specified than physical segments available, 
logical segments will be assigned to available physical segments and an error message 
is displayed indicating that the remaining logical segments are unassigned. If 
physical-segment-number is omitted in the command, the ICE emulator assigns 
from unassigned physical segments in the designated memory. If Intellec or disk 
memory is specified, an error occurs if the resulting physical segment is not one of 
those previously declared by a MAP INTELLEC or MAP DISK command. An 
error also occurs if there are insufficient physical segments unassigned to map the 
specified logical segments. 



The Display MAP Status command displays the current setting of the map for the 
unguarded memory segments specified by partition, if given. If a partition is not 
given, all the unguarded segments for the entire range from 0 to 1023 are displayed. 
The display is to the following format. The segments are displayed, four segments 
per line, each of the form: 

logical-segment = type physical-segment [N] 

where: 

logical-segment = four decimal digits with T suffix 

type = ICE : : USE : : INT : : DIS 

physical-segment = four decimal digits with T suffix for ICE, INT, DIS and four 
physicalsegment = blanks for USE 

Example 1 . 
MAP 0 TO 3 
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Display: 



0000T = USE 



0001T = ICE 0000T 0002T = INT 0064T 0003 = DIS 0000T 



Example 2. 



MAP 



Display: 



0000T = USE 
0004T =DIS 



0001T =ICE 
0001T 0004T = DIS 



0000T 0002T =INT 
0002T 0006T = USE 



0064T 0003 = DIS 0000T 
0007 = USE 



1023T = DIS 



The RESET MAP sets the memory map to its initial condition, all GUARDED, and 
"undeclares" the DISK and INTELLEC memory available. Multiple logical 
segments may be mapped to the same physical segment. Reassignment of a logical 
segment to a different physical segment causes the physical segment originally 
mapped' to become "guarded," or unused, and reassignable, providing no other 
logical segment is currently mapped to it. 
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MAP DISK Command 

MAP DISK = [.drive: ]filename 

Examples: 

MAP DISK = :F0: MYPROG 
MAP DISK = :F1:TEST1 
MAPDIS = TEST2 

MAP A command keyword referring to some operation on the ICE-86A 

map. 

DISK A command modifier that specifies that an ISIS-1I disk file is to be 

opened and available for mapping user memory to. 

-.drive: The diskette drive (:F0:,:Fl:,:F2:,or :F3:) that contains the target 

file. If no drive is specified, :F0: (drive 0) is the default. 

filename The name of the desired disk file that is to be opened. The filename 

follows the second colon with no intervening spaces. 

The assignment operator. 
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MAP INTELLEC Command 



MAP INTELLEC 



{segmentno [TO segmentno] \ T, segmentno [TO segmentno] ~] 
segmentno LENGTH segmentlen J segmentno LENGTH segmentlen^ ... 



Examples: 



MAP INTELLEC = 1023 
MAP INTELLEC = 100 T0 123 
MAP INT = 100 LENGTH 23 

MAP INT = 65, 68 TO 76, 100 LEN 23, 200 TO 250, 260 

MAP A command keyword referring to some operation on the ICE-86A 

map. 

INTELLEC A command modifier specifying Intellec memory. 

segmentno A segment number (64 to 1023) that specifies a physical memory 
segment in Intellec memory. It is used to map Intellec memory in 
one of the following ways: 

• As the address of a single physical segment in Intellec memory. 

• As the address of the first physical segment in Intellec memory 
of a partition of physical segments being mapped. 

• As the address of the last physical segment in Intellec memory 
of a partition of physical segments being mapped. 

TO A connector keyword that denotes that a segment number is to 

follow that defines the upper bound of a memory partition. 

LENGTH A connector keyword that denotes that a segment length value is to 

follow. 

segmentlen A segment length value (1 to 960) that defines the length of a 
partition of memory. 

The assignment operator. 

NOTE 

All mapping to Intellec memory is contingent upon the amount of expanded 
Intellec memory a user has in his system. 
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Set MAP Status Command 



GUARDED 

USER [NOVERIFY] 

ICE \physegmentno ] [NOVERIFY] 

INTELLEC Iphysegmentno] [NOVERIFY] 

DISK \physegmentno] [NOVERIFY] 



Examples: 

MAP 457= ICE 0 NOVERIFY 
MAP 100 TO 200 = USER 
MAP 201 LEN 62 = INT 65 NOV 
MAP 263 LENGTH 87 = DISK 100 
MAP 351 TO 400 = DISNOV 
MAP 401 TO 456 = GUARDED 
MAP 458 T0 1023 GUA 



MAP l ,0 9 se 9 mentno [TO logsegmentno] \ _ ^ 
I logsegmentno LENGTH segmentlen J ~ 



MAP A command keyword referring to some operation on the ICE-86A 

map. 

logsegmentno A logical segment number (0 to 1023) that specifies a segment in 
logical address space. It is used to set the ICE-86A map in one of 
the following ways: 

• As the address of a single segment of logical addresses. 

• As the address of the first segment of a partition of logical 
addresses. 

• As the address of the last segment of a partition of logical 
addresses. 

TO A connector keyword that denotes that a logical segment number is 

to follow that defines the upper bound of a partition of logical 
segments. 

LENGTH A connector keyword that denotes that a logical segment length 

value is to follow defining a partition of logical segments. 

segmentlen A segment length (1 to 1024) that defines the length of partition of 
memory. 



The assignment operator 

GUARDED The initial state of all memory segments. Any reference to a 

guarded address causes an error message. In the emulation mode, 
accesses to a guarded location will cause emulation to terminate 
upon completion of the current instruction. In the interrogation 
mode, no access to the given location will be made. 

USER Refers to locations in user prototype memory. 

ICE Refers to locations in ICE-86A memory. 

INTELLEC Refers to locations in Intellec memory. 

DISK Refers to locations in diskette memory. 
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physegmentno A physical segment number (0 to 1023) that specifies a physical 
segment of memory locations. Intellec expanded memory physical 
segment numbers are limited to a range of 1-960. If present in the 
command, the first logical segment in the partition is set equal to 
the value of physegmentno and the subsequent logical segments are 
set equal to the subsequent physical segment number values. If no 
physegmentno is entered, the ICE-86A emulator assigns physical 
segments from those declared but not yet mapped to. 

NOVERIFY A function keyword that suppresses the normal read-after-write 

verification of data loaded into the designated memory. 
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Display MAP Status Command 




logsegmentno [TO logsegmentno] 
logsegmentno LENGTH logsegmentlen 



MAP 

MAP 0 T0 100 

MAP 123 LENGTH 200 

MAP 300 LEN 400 



MAP 

logsegmentno 
TO 

LENGTH 
logsegmentlen 



A command keyword referring to some operation on the ICE-86A 
map. 

A segment number (0 to 1023) that specifies a segment of addresses 
in logical address space. It is used in the following ways: 

• As the address of a single segment of logical addresses. 

• As the address of the first logical segment of a partition of 
logical segments. 

• As the address of the last logical segment of a partition of 
logical segments. 

A connector keyword that denotes the following segment number 
def ining the upper bound of a partition of logical segments. 

A connector keyword that denotes the segment length value 
defining the length of a partition of logical segments. 

A segment length (1 to 1024) that defines the length of a partition 
of memory. 
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RESET MAP Command 



RESET MAP 



Example: 



RESET MAP 



RESET A command keyword that restores its object to its initial state, as 

after an initial ICE-86A invocation. 

MAP As the object of RESET, the token MAP causes the memory map 

to be set to its initial condition, all GUARDED. The available 
DISK and INTELLEC memory is deleted from the map. 
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Set Memory and Port Content Commands 

The commands in this section set new values or change the current content stored in 
designated memory locations or input/output ports. The commands discussed in 
this section are as follows. The purpose of each command is indicated by its title. 



Command 

Set Memory Contents 



Set Input/Output Port Contents 



Discussion 



Memory Content References 

A memory content reference has the form: 

memory-type address 

[ Wmod-name ] \symbol-name ... 

The meta-term memory-type means one of the following 'content-of ' modifiers for 
memory locations. 

BYTE The content of a single byte (8-bit) memory location. The address 

following BYTE is treated as a logical address; the physical address 
whose content is referenced is determined by look-up in the 
ICE-86A memory map (see Memory and I/O Port Mapping 
Commands). 



WORD The content of two adjacent bytes in memory. The most-significant 

byte is located in the high address of the address pair; the least- 
significant byte is stored in the low address of the pair. The address 
following WORD is treated as a logical address; the ICE-86A 
memory map is consulted to find the physical address whose con- 
tent is referenced. 



SINTEGER 

INTEGER 

POINTER 



REAL 



The same as BYTE except when displaying. 

The same as WORD except when displaying. 

The content of four adjacent bytes in memory, interpreted as a base 
and displacement. The displacement is located at the low 2 bytes of 
the 4, and the base is at the high 2 bytes. The address following 
POINTER is treated as a logical address; the ICE-86A memory 
map is consulted to find the physical address whose content is 
referenced. 

(Also called "Short Real" in some manuals.) The content of four 
adjacent bytes in memory, interpreted as a real number. The 
address following REAL is treated as a logical address; the 
ICE-86A memory map is consulted to find the physical address 
whose content is referenced. The highest bit of the highest byte con- 
tains the sign field. The exponent field stretches from the second- 
highest bit of the highest byte through the highest bit of the second- 
highest byte (eight bits). The remaining twenty-three bits are 
dedicated to storing the significand field. 
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DREAL (Also called "Long Real" in some manuals.) The content of eight 

adjacent bytes in memory, interpreted as a real number. The 
address following DREAL is treated as a logical address; the 
ICE-86A memory map is consulted to find the physical address 
whose content is referenced. The highest bit of the highest byte con- 
tains the sign field. The exponent field stretches from the second- 
highest bit in the highest byte through the fourth-highest bit in the 
second highest byte (eleven bits). The remaining fifty-two bits are 
dedicated to storing the significand field. 

TREAL (Also called "Temporary Real" in some manuals.) The content of 

ten adjacent bytes in memory, interpreted as a real number. The 
address following TREAL is treated as a logical address; the 
ICE-86A memory map is consulted to find the physical address 
whose content is referenced. The highest bit of the highest- 
addressed byte contains the sign field. The exponent field stretches 
from the second-highest bit of the highest byte to the lowest bit of 
the second-highest byte (fifteen bits). The remaining sixty-four bits 
are dedicated to storing the significand field. 

Real numbers (type REAL, DREAL, or TREAL) are stored in three "fields": the 
number's significant digits are held in the significand field, the exponent field 
locates the binary point within the significant digits, and the sign field indicates 
whether the number is positive or negative. The most significant digits of each field 
are stored in the highest addresses. See figure 7-1 for the format of these types in 
memory. 

See The 8086 Family User's Manual Numerics Supplement, Manual Order Number: 
121586, for further details on the storage of real values. 

The meta-term address means one of the following types of entries. 

numeric-expression The forms for numeric expressions are presented in Chap- 
ter 5. The result obtained when the expression is evaluated 
becomes an address modulo 64K. 

(mem-type address) A memory content reference with a form such as BYTE 
(WORD 1000) represents an indirect reference. The content 
of the address or address-pair inside the parentheses is treated 
as the address for the mem-type outside the parentheses. 

To obtain the content of bytes, words, or pointers in a range of addresses, use the 
form: 

memory-type partition 

A partition can be a single address or one of the following types of constructs: 

address TO address 

address LENGTH number-of-bytes (for BYTE and SINTEGER) 
address LENGTH number-of-words (for WORD and INTEGER) 
address LENGTH number-of-double-words (for POINTER) 

i 

The first form of partition uses the keyword TO. The address on the right of the 
keyword TO must be greater than or equal to the one on the left. With BYTE and 
SINTEGER, this form allows you to access the content of each byte location in the 
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Figure 7-1 . REAL, DREAL and TREAL Memory Types 162554 8 



range; the range includes both the first and last address in the partition. With 
WORD or INTEGER, the first address is treated as the low address of the first 
address pair in the range; subsequent pairs of addresses are accessed until the second 
address is reached. If the second address is the low address of a pair, the word 
formed from the content of that address and the next consecutive higher address is 
accessed; if the second address is not the low address of a pair (that is, if it turns out 
to be the high address of a pair already accessed in the range), the access ends after 
the last complete pair has been accessed. Word-length accesses can begin on either 
an even-numbered or an odd-numbered address. With POINTER, the first address 
is treated as the low address of the first address quadruple in the range; subsequent 
quadruples of addresses are accessed until the second address is reached. If the 
second address is the4ow address of a quadruple, the pointer formed from the con- 
tent of that address and the next three consecutive higher addresses is accessed; if the 
second address is not the low address of the quadruple, the access ends after the last 
quadruple has been accessed. Pointer-length accesses can begin on either an even- 
numbered or an odd-numbered access. 
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The second, third and fourth forms use the keyword LENGTH. The address 
preceding the keyword LENGTH is the starting address in the range, as with the first 
form (using TO). The number or expression following the keyword LENGTH gives 
the number of addresses (when the controlling memory-type is BYTE or 
S1NTEGER), the number of address pairs (for WORD or INTEGER), or the 
number of addresses quadruples (for POINTER). (Must be an integer value.) 



Setting Memory Contents 

To assign a new content to a byte, sinteger, word, integer, pointer or real location, 
use a command with the form: 

mem-type address = new-content \ 
[Wmod-name ]! symbol-name... J 

The meta-terms mem-type and address represent the types of entries discussed 
earlier in this section. 

The meta-term new-content represents one of the following types of entries (for 
single addresses, setting the content of a range of addresses will be discussed later 
on). 

numeric-expression A numeric expression evaluated by the ICE-86A emulator to 
a single number. 

If mem-type is a POINTER, new-content must be a pointer value. Otherwise, new- 
content must be an integer value. 

When a single byte address is to be set, the ICE-86A emulator treats the new-content 
as an 8-bit quantity. If new-content has more than eight bits, the least-significant 
eight bits in the quantity are used as the new content, and the other (higher) bits are 
lost. If new-content has fewer than eight bits, the bit values in the quantity are right- 
justified (placed in the low-order bits in the address), and the remaining (high) bits in 
the location are set to zeroes. 

Here are some examples of setting byte contents. The first line of each example 
shows the command that sets the new contents; the second line gives a command 
that produces a display of the contents just set; the third line shows the resulting 
display. The output radix is assumed to be H (hexadecimal). 



*BYTE 1000H = FFH 


(or)* BYTE 0100:0000= FFH 


*BYTE1000H 


* BYTE 0100:0000 


BYT 0000:1000H=FFH 


BYT 0100:0000H=FFH 


*BYTE 1010H = RAL + 1 


(or)*BYT100:10H = RAL + 1 


* BYTE 101 OH 


* BYT 100:1 OH 


BYT 0000:1010H=F1H 


BYT 0100:0010H=F1H 


*BYTE1020H = FF11H 


(or)*BYTE 100:20 = FF11H 


*BYTE1020H 


*BYTE 100:20 


BYT 0000 : 1 020 H=11H 


BYT 0100:0020H=11H 


*BYTE1030H = 1Y 


(or)* BYT 103:0 = 1Y 


*BYTE1030H 


*BYT103:0H 


BYT 0000:1 030H=01H 


BYT0103:0000H=01H 


*BYTE1040H = 'A' 


(or)* BYT 104:0 = 'A' 


*BYTE1040H 


* BYT 100:40 


BYT 0000:1 040H=41H 


BYT0100:0040H=41H 
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*BYTE 1050H = BYTE 1000H 

*BYTE1050H 

BYT 0000:1 050H=FFH 



(or)* BYTE 100:50H = BYT100:0H 
* BYT 105:0 
BYT0100:0050=FFH 



You can change the radix used to display the contents using the Set Output Radix 
(BASE) command. 

When a single word address is to be set, the ICE-86A emulator treats the new- 
content as a pair of bytes. The least-significant byte is loaded into the low address in 
the pair, and the most-significant byte is loaded into the high address in the pair. If 
new-content has fewer than 16 bits, the bit values are loaded starting with the low 
address and right-justified. The remaining (high) bits in the address pair are set to 
zeroes. The following examples demonstrate some of the possibilities for the setting 
address pairs: 



*WORD1000H = 1122H 
*WORD1000H 
WOR 0000:1 000H=1122H 



(or)*WORD0:1000H = 1122H 
*WOR0:1000H 
WOR0000:1000H=1122H 



*WORD1010H = FFH 

♦WORD1010H 

WOR0000:1010H=00FFH 



(or)*WOR101:0H=FFH 
* WORD 101:0 
WOR0101:0000H=00FFH 



*WORD 1030H = WORD 1000H 

*WORD1030H 

WOR 0000:1 030H=1122H 



(or)*WORD 0:1030H = WOR 0:1000H 
* WOR 103:0 

WOR0103:0000H=1122H 



When a single pointer is to be set, the ICE-86A emulator treats the new-content as a 
displacement and base. The least-significant byte is loaded into the low address in 
the quadruple, and most-significant byte is loaded into the high address. The follow- 
ing examples demonstrate some of the possibilities for setting pointers: 

* POINTER 1000H = 1122.3344H (or)*PO1 100:0 = 1122:3344H 

'POINTER 10000H *POI 0:1000H 

POl 0000:1000H=1122:3344H POI 0000:1 000H=1 122: 3344 H 



Assume that X and Y refer to any symbol name. A command of the form BYTE X = 
BYTE Y copies the content of the address Y to the content of address X where 
addresses X and Y are either integer or pointer values as shown in the examples 
above. A command of the form WORD X = WORD Y copies the content of address 
Y to location X, and the content of address (Y+l) to location (X+l). A command of 
the form POINTER X = POINTER Y copies the content of location Y through 
(Y+3) to locations X through (X+3) respectively. A command of the form BYTE X 
= WORD Y copies the content of address Y to location X; the content of location 
(X!l) is unchanged. A command of the form WORD X = BYTE Y copies the con- 
tent of address Y to location X; the content of location (X+l) is set to a byte of 
zeroes. POINTER X = BYTE Y copies (Y) to (X) zeroes in (X) + 1 to (X) + 3. 

This also works for REALs of the same type. A command of the form DREAL X = 
DREAL Y copies the content of the address Y to the content of address X. 

The commands used to set a range of addresses differ in some details. 

One way to set a range of addresses is with the command of the form: 

mem-type address =list of new-content values 

With this form the address on the left side of the equals sign gives the starting loca- 
tion, and the number of values in the list to the right of the equals sign tells the 
1CE-86A emulator how many consecutive addresses to load. Consecutive locations 
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are changed to the values of the new-contents in left-to-right order. The list of new 
content values can consist of expressions, multi-character strings, and memory 
partitions. 

Here are some examples showing the use of this form of the set memory contents 
command. 



♦BYTE1000H = 11H, 22H, 33H, 44H, 55H, 66H, *AB' 
*BYT1000H LEN8T 

BYT0000:1000H=11H 22H 33H 44H 55H 66H 41 H 42H 



*WOR 200:0H = FFFFH, WORD 100:0H 
*WOR 200:0H LENGTH 2T 
WOR 0200:0000H=FFFFH 2211 H 



*P01 4000:20H = 1122.3344H, WOR 1002H, BYT 1002 
*POI 4000:20H LEN 3T 

POI 4000:0020H=1 122:3344 0000:4433 0000:0033 

*REAL 100H = -9.9, 44.3E12 
*REAL100 LEN 2 

REAL0000:0100H = -9.89999962E + 0 +4.42999998E + 13 



*TRE 2000 = 1 .0, 2.0, 3.0, 4.1 E-5 
*TRE2000LEN4 

TRE 0000:2000H= + 1 .OOOOOO00O00O000O0E + 0 + 2. 0000000000000000000 E + 0 

TRE 0000:2014H= + 3. 00000000000000000 E + 0 + 4.1 000000000000000000E- 5 

To set a range of addresses all to the same new value, use a command of the form: 



mem-type partition = new-content 



The forms of partition are discussed above in this section. All addresses in the parti- 
tion are set to the single new-content value. The following examples show some of 
the possible results obtained with this command form: 



*BYT 1000H TO 1004H =FFH 

*BYTE1000H LEN 5H 

BYT 0000:1000H=FFH FFH FFH FFH FFH 



*WORD 200:0 LENGTH 6T = AA00H 
*WOR 200:0H TO 200AH 

WOR0200:0000H=AA00H AA00H AA00H AA00H AA00H AA00H 



* POINTER 3000H LEN 3T = 1234.5678H 
POI 0.3000H TO 0:300BH 

WOR 0000:3000H=1 234:5678 1234:5678 1234:5678 



*REA2000 LEN 8 = 1.0, 2.0 
*REA2000 LEN 8 

REA 0000:2000H= + 1 .00000000E + 0 
REA 0000:2008H= + 1 .00000000E + 0 
REA 0000:2010H= + 1 .00000000E + 0 
REA 0000:2018H= + 1 .00000000E + 0 



+ 2.00000000E + 0 
+ 2.00000000E + 0 
+ 2.00000000E + 0 
+ 2.00000000E + 0 



*DRE2000 LEN 4=1.0E-10 
*DRE2000 LEN 4 

DRE 0000:2000H= + 1 .0000000000000000E-1 0 + 1 .0OOOOOOOOOOOOOOOE-1 0 

DRE 0000:2010H= + 1 .0000000000000000 E-1 0 + 1 .0000000000000000E-1 0 
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The last form of the set memory contents command sets the contents of each address 
in a range (partition) to the corresponding new-content in a list of values. This form 
is as follows: 

mem-type partition =list of new-content values 

This form combines the two forms discussed above. The list of new-content values 
can consist of expressions, multi-character strings and memory partitions. 

If the number of locations in the partition is equal to the number of values in the 
new-content list, the addressed locations are set to the corresponding values in the 
list, in left-to-right order. 

If the number of locations in the range is greater than the number of new values in 
the list, the locations are filled with the values from left-to-right, repeating the 
values in left-to-right order as necessary to fill all the locations. The maximum 
number of bytes that can be repeated is 128. With more than 128 bytes, the data is 
transferred but not repeated, and an error message is displayed. 

If the number of new values in the list is greater than the number of locations in the 
partition, the lowest location receives the first value, and successive locations in the 
range receive values in left-to-right order until all locations in the range have 
received values. The excess values are then detected by the ICE-86A emulator as an 
error condition, and an error message is displayed. The excess values are lost. 

Here are a few examples showing this form of command: 

*BYT 1000H TO 1004H = 'ABCDE' 

*BYT 1000H LEN 5T 

BYT 0000:1000H=41 H 42H 43H 44H 45H 

*WORD200:0H LENGTH 6T = 1122H, 'AB\ 
*WOR 200:0HTO 200:AH 

WOR 0220:0000H=1122H 0041 H 0042H 1122H 0041 H 0042H 

*BYTE 1000H TO 1002H = 11H, 22H, 33H, FFH 

ERR 97:EXCESSIVE DATA 

* BYT 100:0 LEN 4T 

BYT 1000:0000=11 H 22H 33H 44H 

In the third example, note that the byte at location 1003H retains the value set in the 
first example in the group of examples (44H rather than the FFH given in the 
command.) 



Port Content References 

The set port contents commands parallel those of the set memory contents com- 
mands with the exception of port addressing. There are a total of 65536 8-bit ports 
available for input/output in the ICE-86A emulator. The ports are referenced by the 
mnemonic PORT. These ports can be referenced as 16-bit ports by the mnemonic 
WPORT. Each port is referenced by a port-number that is an integer value in the 
range of 0 through 65535. 

To assign a new content to an 8-bit or 16-bit port, use the following command with 
the form: 

port-type port-number = new-content 
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The meta-terms port-type and port-number are used to specify individual ports. 

port-type Defines the port type and size: 

PORT An 8-bit port. 
WPORT A 16-bit port. 

port-number An integer value specifying a specific port. 
The following are examples of the use of this command form: 

PORT 123 = FFH 

WPORT 123 =FFFFH 
One way of setting a range of ports is with the command of the form: 

port-type port-number =list of new-content values 

With this form the port-number on the left side of the equals sign gives the starting 
port location, and the list to the right of the equals sign tells the ICE-86A emulator 
how many consecutive ports to load. Consecutive ports are changed to the values of 
the new-contents in left-to-right order. 

Here are some examples showing the use of this form: 

PORT 1000H = 11, 22, 33H, 44H, 55H, 66H 

WPORT 1000H = 1122H, 3344H, 5566H 
To set a range of ports all to the same new value, use a command of the form: 

port-type partition = new-content 
The following are examples of this form: 

PORT 1000H T0 1005 = FFH 

WPORT 2000H LENGTH 20H = FFFFH 

The last form of the set port contents sets the contents of each port in a range (parti- 
tion) to the corresponding new-content in a list of values. This form is as follows: 

port-type partition = list of new-content values 

If the number of ports in the partition is equal to the number of values in the new- 
content list, the addressed ports are set to the corresponding values in the list, in left- 
to-right order. 

If the number of ports in the range is greater than the number of new values in the 
list, the ports are filled with the new values from left-to-right, repeating the values in 
left-to-right order as necessary to fill all the ports. 

If the number of new values in the list is greater than the number of ports in the par- 
tition, the lowest numbered port receives the first value, and successive ports in the 
range receive values in left-to-right order until all ports in the range have received 
values. The excess values are then detected by the ICE-86A emulator as an error con- 
dition, and an error message is displayed. The excess values are lost. 



7-41 



Interrogation and Utility Commands 



ICE-86A 



Here are a few examples showing this form of command: 

PORT 1000 TO 1005H = 'ABODE' 

WPORT 2000H LEN6T = 1122H, 'AB' 

PORT 1000H TO 1002H = 11H, 22H, 33H. FFH 

(an error message such as EXCESS VALUES is displayed) 

NOTE 

Byte, Word, and Port commands respond with DONE timeouts if 
RWTIMEOUT = INFINITE and no user ready occurs for 15 seconds. 
However, the 8086 is still active on the user bus until the RESET HARD- 
WARE command is entered. 
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Set Memory Command 

mem-type partition =new-content[, new-content] ... 
typed-mem-ref = numeric-expression 

Examples: 

BYTE 0800H = FFH 

BYTE 7000H LENGTH 16T = 00H 

BYT 0800 TO 0805 = 12H, 34H, 56H, 78H, 9AH, BCH 

WORD70FFH = IP 

WOR7000H = PIP +1 

POINTER 8000H = ABCD.1234H 

BYTE0800H = 'ABODE' 

POI 7000H = POI 4000H LEN 20H 

BYT #56 = FAH 

!VAR = 75 

!X = !X + 1 

!!MODA!PTR = SS:SP 
REA 1000H = -12345.6789E-5 



mem-type One of the nine memory 'content-of modifiers BYTE, WORD, 

SINTEGER, INTEGER, POINTER, REAL, DREAL, or TREAL. 

partition One or more contiguous locations in memory. 

new-content One of the following types of entries, to be used as the new contents 
of the memory location: 

n um eric-expression 
'string' 

mem-type partition 
port-type partition 



typed-mem-ref See Typed Memory Reference in Chapter 5 . 
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Set Input/Output Port Contents Command 

port-type partition = new-content [, new-content]... 

Examples: 

PORT 0800H=FFH 

PORT 7000H LENGTH 16T = 00H 

POR 0880 TO 0885 = 1 2H , 34H , 56H , 78H , 9A, BCH 

WPORT70FFH = IP 

WPO 7000H = PIP + 1 

PORT 0800H = 'ABODE' 

PORT#56 = FAH 

port-type One of the two port 'content-of modifiers PORT or WPORT. 

partition One or more contiguous ports (must be integers). 

new-content One of the following types of entries, to be used as the new contents 
of the port: 

n urn eric-expression 
'string' 

mem-type partition 
port-type partition 
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Symbol Table and Statement Number 
Table Commands 

The 1CE-86A emulator maintains a symbol table and source program statement 
number table to allow you to refer to memory addresses and other values by using 
symbolic references and statement references in the ICE-86A commands. 

This section gives details on the following commands: 



Command 

DEFINE Symbol 
Display Symbols 
Display Statement Numbers 
Display Modules 
Change Symbol 
REMOVE Symbols 
REMOVE Module 
TYPE 

Set DOMAIN 
RESET DOMAIN 

ENABLE/DISABLE Symbolic Display 

Discussion 

The 1CE-86A symbol table receives symbols from two sources; the symbol table 
associated with the user program can be copied to the ICE-86 A symbol table when 
the program is loaded, and the user can define additional symbols for use during the 
emulation session. 

Corresponding to each symbol in the table is a number that you can interpret and 
use either as an address or as a numeric value (variable or constant). The next few 
paragraphs discuss the kinds of symbols that can appear in the table, and the inter- 
pretation of the corresponding symbol table quantity (address or value). 

Instruction and statement labels are loaded with the program code. The symbol 
table gives the address of the instruction corresponding to the label. 

A program variable is a symbol for a quantity that can have its value changed as a 
result of an instruction in the program. Program variables are LOADed with the 
program code. The symbol table gives the address where the variable value is stored. 

A program constant is a symbol for a label set to a constant value (for example, 
using the assembler directive EQU or SET). Program constants are loaded into the 
symbol table when the program code is loaded. The symbol table gives the constant 
value associated with the symbol. 

A module name is the label of a simple DO block that is not nested in any other 
block (for PL/M-86), or a label that is the object of a NAME directive (in 8086 
assembly language). If no NAME directive is given, the module name is the same as 
the source file name without the extension. For example, if the source file name is 
":F1 :MYPROG.A86", the module name will be "MYPROG". 

A module name itself does not have a corresponding address value in the symbol 
table. However, symbols contained in a module are considered to be 'local' to that 
module; the 1CE-86A emulator thus allows you to reference multiple occurrences of 
the same symbol name in different modules, by using the module name as a modifier 
in the symbolic reference. 
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The ICE-86A symbol table is organized to preserve the modular structure present in 
the program. Initially (before any code is loaded), the symbol table consists of one 
'unnamed' module. Any symbols defined without a specific module name are stored 
in the unnamed module in the order they were defined. The unnamed module is 
always the first module in the symbol table. Following the unnamed module, named 
modules are stored in the symbol table in the order that the modules were loaded 
into the ICE-86A emulator. Symbols local to each named module are stored in the 
order they appear in the module. 

In addition to the symbols stored when the program code is loaded, you can use the 
DEFINE Symbol command to define new symbols for your use during the emula- 
tion session. The rules for user-defined symbols are as follows. 

The name of the new symbol (symbol-name ) can be defined with a maximum of 122 
characters. However, the ICE-86A emulator truncates each symbol-name to the first 
31 characters. Thus, to be different, two symbols must be unique in the first 31 
characters. 

The first character in the new symbol-name must be an alphabetic character, or one 

of the two characters @, underscore ( ), dollar sign ($), or ?. The remaining 

characters after the first can be these characters or numeric digits. 

You can specify the module that is to contain the new symbol you define. Symbols 
defined without a module are placed in the unnamed module at the head of the 
table, in the order they were defined. Symbols defined with an existing module name 
are placed in that module's section of the table; the module named must already 
exist in the table. 

The new symbol name cannot duplicate a symbol name already present in the 
module specified. You can, however, have two or more symbols of the same name in 
different modules. 

When you define a new symbol, you also specify the value corresponding to it in the 
table. You can treat the value you assign as an address or as a numeric value for use 
other than addressing. 

The DEFINE Symbol command has the following form: 

DEFINE symbolic-reference^ address::value[OF memory-type] 

The forms of symbolic-reference are shown in table 7-8. The meaning of each form 
is as follows. Not all forms can be used in a DEFINE Symbol command. 

A simple symbolic-reference has the form .symbol-name. The ICE-86A emulator 
searches for this form of reference starting with the first symbol in the unnamed 
module. If the symbol is not in the unnamed module, the ICE-86A emulator 
searches through the named modules in the order they were loaded, and takes the 
first occurrence of the symbol in the first (earliest) module that contains it. 

When you define a symbol without a module, it is placed in the unnamed module. 

The symbolic-reference can include a module-reference. The module reference 
immediately precedes the symbol name; the module-name is identified by a prefix 
consisting of a double period (..). When you define a symbol with a module 
reference, the symbol is added to the symbols under that module. A later reference 
to a symbol with a module name restricts the search to that module. 

The meta-term address/value as used in the DEFINE Symbol command means one 
of the forms of numeric expressions given in Chapter 4. 
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Table 7-8. Symbolic References and Statement References 



Type of 
Reference 


Meta-notation 


Example 


Display 


DEFINE 


Change 


REMOVE 


Symbolic 


.symbol-name 


.ABC 


YES 


YES 


YES 


YES 


Symbolic 


. module. symbol-name 


..MAIN.DEF 


YES, if module is already present in table. 


Symbolic 


.symbol-name, symbol-name 


XX.YY 


YES 


NO 


YES 


YES 


Statement 


^statement-number 


#56 


YES 


NO 


NO 


NO 


Statement 


. .module#stmt-number 


..MAIN#4 4 


YES 


NO 


NO 


NO 



The meta-term memory-type is one of the following memory types: BYTE, WORD, 
S1NTEGER, INTEGER, POINTER, REAL, DREAL, or TREAL. 



Once a symbol has been defined or loaded, any reference to that symbol is 
equivalent to supplying its corresponding address or value. 

To display the value from the symbol table corresponding to any symbol, enter the 
appropriate symbolic reference followed by a carriage return. The ICE-86A 
emulator displays the symbol table value on the next line. 

To display the entire ICE-86A symbol table, enter the command SYMBOL followed 
by a carriage return. Symbols are displayed module by module, starting with the 
unnamed module. The address/value corresponding to each symbol is also 
displayed. 

Example 1 : 
\SAM 

.SAM=0200:1FE2H OF INT 

Example 2: 

\.MYPROG .SAM 
.SAM=0200:1FE2HOFINT 

Example 3: 

*SYMBOL 
.TEMP=0000:0001H 
MODULE ..MAIN 
.BEGIN=0800:0050H 
.VAR=0800:0100H OF BYT 
MODULE. SUBR 
.PROC=0800:0069H 
.X=0800:0t01HOFWOR 

The ICE-86A emulator also maintains a statement number table for user programs 
written in PL/M-86 source code. The statement numbers are assigned by the 
PL/M-86 compiler. Corresponding to each source statement number in the table is 
the address of the first instruction generated by that source statement. 

Table 7-8 shows the forms used to refer to statement number in the ICE-86A 
emulator. The simplest form is the statement-number prefixed by a number sign (#). 
A module-reference can precede the statement reference, since the statement 
number table preserves any modular structure in the program. Thus, two modules 
compiled separately can have the same statement numbers; the module reference 
tells the ICE-86A emulator which statement number to use. 



(command) 
(display) 



(command) 
(display) 



(command) 
(display) 
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To display the address corresponding to a statement-number, enter the appropriate 
statement number reference followed by a carriage return. 

The ICE-86A emulator does not allow you to change the address corresponding to 
any existing statement number, to define any new statement numbers, or to delete 
(REMOVE) any statement numbers. 

To display the value from the statement number table of any statement number, 
enter the appropriate statement number reference followed by a carriage return. The 
ICE-86A emulator displays the statement number value on the next line. 



Example 1 : 

*#1 (command) 
#1=0800:0050H (display) 



Example 2: 

\. MAIN #2 (command) 
#2=0800:0057H (display) 



To display the addresses of all the statement numbers in the statement number table, 
enter the keyword LINE. The ICE-86A emulator displays all the statement number 
addresses starting on the line following the command. 

Example: 

*LINE (command) 

MODULE. MAIN (display) 

#1=0800:0050H 

#2=0080 :0057H 

MODULE. .SUBR 

#1=1140:0012H 

#2=1140:0037H 

#3=1140:00DFH 



To display the names of all the modules currently in the ICE-86A module table, 
enter the keyword MODULE. The ICE-86A emulator displays the names of all the 
modules currently in the table. 

Example: 

'MODULE (command) 
MODULE. .MAIN (display) 
MODULE. .SUBR 

You can change the address/value corresponding to an existing symbol by entering a 
command of the form: 

symbo/ic-reference=address::value [OF memory-type ] 

Any of the three forms of symbolic-reference shown in table 7-7 can be used to iden- 
tify the symbol whose value is to be changed. The symbol must already exist as 
referenced. 

The forms of address', '.value are discussed earlier in this section. Any of these forms 
may be used to change the value of an existing symbol. 
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Where multiple occurrences of the same symbol name exist in the table, the rules for 
table search given earlier determine which or the several instances of the symbol is to 
receive the new address value. 

To delete one or more symbols from the table, use a command of the form: 

REMOVE list of symbolic-references 

The symbolic-references in the list are separated by commas. The ICE-86A emulator 
searches the table for each reference using the search rules given earlier, deleting the 
first occurrence of each symbol name that fits the type of reference given. 

Note that deleting a symbol from the ICE-86A symbol table makes that symbol 
inaccessible to the ICE-86A emulator but does not affect the program code. 

To delete the entire 1CE-86A symbol table and the statement number table, enter the 
command REMOVE SYMBOL. 

To delete one or more modules, enter the following command: 

REMOVE MODU LE module-name {, module-name ]... 

Removing a module removes all symbols and statement numbers in the module, but 
does not affect object code. 

Example 1 : 

REMOVE MODULE. .MAIN 
Example 2: 

REM MOD. . MAIN, ..SUBR 

The TYPE command allows you to assign or change the memory type of any symbol 
in the symbol table. The TYPE command is entered in the following format: 

TYPE symbolic-reference = memory-type 
The referenced symbol is assigned the memory type entered in the command. 
Example: 

TYPE ..MY PROG .SAM = WORD 
The symbol .SAM now is memory type WORD. 

The Set DOMAIN command establishes a specified module as the default module 
for statement numbers. The RESET DOMAIN command establishes the first 
module in the module table after the unnamed module as the default for statement 
numbers, if there is a module other than the unnamed module; otherwise it 
establishes the unnamed module as the default. This is the initial domain. 

Setting the domain should be especially useful for avoiding having to use module 
names on statement numbers from a particular module while debugging that portion 
of the program. 

When symbolic display is enabled, the ICE-86A emulator attempts to display values 
in pointer format in terms of symbols stored in the symbol table and statement 
numbers stored in the statement number table. Given an address b:d to represent, 
the ICE-86A emulator linearly searches first the symbol table and then the statement 
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number table for symbols or statement numbers associated with base b and the 
largest displacement less than or equal to d. If more than one such symbol or state- 
ment number is found, then the ICE-86A emulator displays the first located item. 

The display is in the form: 

module-name j symbol 1 + remainder (if greater than 0) 
\#decimal-10 J 

where remainder is the number of bytes difference between d and the displacement 
associated with the symbol or statement number. 



In the case of a memory display, only if an exact address match is found (remainder 
= 0) is the symbolic information displayed. The display occurs on the line immedi- 
ately preceding the normal address reference. 

Example: 

* BYTE 100 = 05H 
*DEF.Z = 100HOFWORD 

* BYTE 100 
Z 

BYT0000:0100H=05H 



In the case of a register display, an exact address match is not necessary (i.e., 
remainder does not have to equal 0). The symbolic information is displayed instead 
of the address. 



Example: 

*DEF.Z = 100HOFPOI 
*GO 

EMULATION BEGUN <esc> 

EMULATION TERMINATED, CS:IP= Z + 053DH 



Observe that the symbolic display is not affected by whether or not the symbol or 
memory reference is of type pointer; symbolic display occurs whenever a value is to 
be displayed in pointer format. If no symbol or statement number can be found that 
has associated with it an address with base equal to b, then normal display occurs. 

Symbolic display is initially disabled. To enable symbolic display, type ENABLE 
SYMBOLICALLY. To disable symbolic display again, type DISABLE 
SYMBOLICALLY. 
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DEFINE Symbol Command 

DEFINE [module-name ] symbol = expression [OF memory-type ] 

Examples: 

DEFINE ..MAIN .BEGIN = F3H OF BYTE 

DEF.CAR = 0000:0F00H 

DEF .VAR = 123TOFWOR 

DEF .ENT1 = .VAR + 10 OF WOR 

DEF .CAT2 = 0700:0050H OF POI 

DEF ..SUBRA .CAT2 = 0000:00F0H OF POI 

DEF .RE = 0001T OF REAL 

DEFINE A command keyword that tells the 1CE-86A emulator to enter the 

new symbol in the appropriate module table, and assign the symbol 
the initial value given. 

module-name A sequence of contiguous alphanumeric characters, prefixed by a 
pair of periods (..) that references a program module. 

symbol A sequence of contiguous alphanumeric characters, prefixed by a 

period (.) that references a location in a symbol table. 

The assignment operator. 

expression A numeric expression. 

OF A command modifier keyword denoting that a specification of 

memory type is to follow. 

memory-type A specification of the memory type of the symbol: BYTE, WORD, 
SINTEGER, INTEGER, POINTER, REAL, DREAL, or TREAL. 
If omitted, symbol has no type. 
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Display Symbols Command 

SYMBOL 

[module-name ] symbol [symbol ]... 
Examples: 
SYMBOL 

.TEMP=0000:0001H 

MODULE ..MAIN 

.BEGIN=0800:0050H 

.VAR=0800:0100HOFBYT 

MODULE. .SUBR 

.PROG=0800:0069H 

.X=0800:0101HOFWOR 

SYMBOL A command keyword that tells the 1CE-86A emulator to display 

the entire ICE-86A symbol table, module by module. 

module-name A sequence of continuous alphanumeric characters, prefixed by a 
pair of periods (..) that reference a program module. 

symbol A sequence of contiguous alphanumeric characters, prefixed by a 

period (.) that references a location in a symbol table. 
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Display Statement Numbers Command 



LINE 

[module-name] #decimal-10 

Examples: 

LINE 
#54 

..MAIN#44 



LINE A command keyword that tells the ICE-86A emulator to display all 

statement numbers and associated absolute addresses in the current 
domain. 

module-name A sequence of contiguous alphanumeric characters, prefixed by a 
pair of periods (. .) that reference a program module, 

# The 'number' sign designating the reference as a statement number. 

decimal-10 The (source) statement number (a numeric constant). The default 

suffix is always decimal. 
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Display Modules Command 

MODULE 
Example: 
MODULE 

MODULE A command keyword that tells the ICE-86A emulator to display 

the names of all the modules currently in the ICE-86A module 
table. 
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Change Symbol Command 

[module-name ] symbol [symbol ]... = expression [OF memory-type ] 
Examples: 

.ABC = 2000H 

..MAIN.DEF = AAFFH OF WOR 
..SUBR.PARM = .ABC + 10 
.TEMP = .ABC + ..MAIN.DEF OF WORD 
.R = 1001 H OF REAL 



module-name A sequence of contiguous alphanumeric characters, prefixed by a 
pair of periods (..) that references a program module. 

symbol A sequence of alphanumeric characters, prefixed by a period (.) 

that references a location in the symbol table. 

The assignment operator. 

expression A numeric expression. 

OF A command modifier keyword denoting that a specification of 

memory type is to follow. 

memory-type A specification of the memory type of the changed symbol: BYTE, 
WORD, S1NTEGER, INTEGER, POINTER, REAL, DREAL, or 
TREAL. If omitted, do not change symbol's type. 
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REMOVE Symbols Command 

REMOVE [module-name} sy [symbol]...} 

REMOVE SYMBOL 

REMOVE MODULE module-name [,module-name]... 

Examples: 

REMOVE .ABC 
REMOVE!. MAIN. DEF 

REMOVE . HIJ, . PARM1, ..MAIN.TWO,. CARS,. CARS1..SUBR.XX 
REMOVE SYMBOL 

REMOVE MODULE ..MAIN,..SUBR,..CALC 

REMOVE A command keyword causing the symbols that follow to be deleted 

from the ICE-86A symbol table. 

module-name A sequence of alphanumeric characters, prefixed by a pair of 
periods (..) that references a program module. 

symbol A sequence of alphanumeric characters, prefixed by a period (.) 

that references a location in the symbol table. 

SYMBOL A command modifier that tells the ICE-86A emulator to delete the 

entire current ICE-86A symbol table. 

MODULE A command modifier that tells the ICE-86A emulator to delete all 

the symbols and lines of the named module from the 1CE-86A 
tables but does not affect object code. 



7-56 



ICE-86A 



Interrogation and Utility Commands 



TYPE Command 

TYPE [module-name] symbol [symbol]... = memory-type 

Examples: 

TYPE .ABC = POINTER 

TYPE ..MAIN.DEF = WOR 

TYPE ..SUBR.PARM,.XX,.YY = BYT 

TYPE .R = REAL 



TYPE A command keyword that allows the user to assign or change the 

memory type of any symbol in the symbol table. 

module-name A sequence of alphanumeric characters, prefixed by a pair of 
periods (..) that references a program module. 

symbol A sequence of alphanumeric characters prefixed by a period (.) that 

references a location in the symbol table. 

The assignment operator. 

memory-type A specification of the memory type to be assigned to the referenced 
symbol: BYTE, WORD, SINTEGER, INTEGER, POINTER, 
REAL, DREAL, or TREAL. 
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Set DOMAIN Command 

DOMAIN module-name 
Example: 

DOMAIN ..MAIN 

DOMAIN A command keyword that causes the ICE-86A emulator to 

establish the named module as the default module for statement 
numbers. 

module-name A sequence of alphanumeric characters prefixed by a pair of 
periods (..) that references a program module. 
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RESET DOMAIN Command 

RESET DOMAIN 
Example: 

RESET DOMAIN 

RESET A command keyword restoring its object to a reset condition. 

DOMAIN A modifier keyword that causes the 1CE-86A emulator to establish 

the first module after the unnamed module as the default module 
for statement numbers. If there are no named modules, the 
unnamed module is established as the default module. 



7-59 



Interrogation and Utility Commands 



ICE-86A 



ENABLE/DISABLE SYMBOLICALLY Command 

ENABLE | SYMBOLICALLY 
DISABLE J 

Examples: 

ENABLE SYMBOLICALLY 
DISABLE SYMBOLICALLY 

ENABLE A command keyword that causes symbolic display to be enabled, 

DISABLE A command keyword that causes symbolic display to be disabled. 

SYMBOLICALLY Command modifier denoting that symbolic display is to be 
enabled/disabled. 
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Display Commands 

This section presents the 1CE-86A commands that allow you to reference and 
display the following systems elements: 

• 8086 Processor Registers 

• ICE-86A Status Registers 

• 8086 Pin Signals 

• Memory 

• Ports 

• Status Flags 

• RQGT and Bus Status 

The following commands are discussed in this section: 



Command 



Purpose 



Display Processor and 
Status Registers 

Display CAUSE 



Display Memory 
Display I/O 
Display STACK 
Display Boolean 
Display NESTING 

EVALUATE 

Display RQGT 

Display BUS 



Display the current contents of any of the 8086 
processor registers and ICE-86A status registers. 

Display strings representing the state of the CAUSE 
register. 

Display the contents of a range of memory. 
Display the contents of a range of I/O locations. 
Display the contents of the user's stack. 
Display boolean values. 

Display the start and return address of all currently 
active procedures. 

Display numeric constant or expression in all five 
possible output radixes. 

Display whether Request/Grant lines operate 
continuously or only while in emulation mode. 

Display what device currently controls the system 
bus. 



Discussion 



Registers 

The 8086 register structure contains three files of four 16-bit registers and a set of 
miscellaneous registers. The three files of registers are the general register file, the 
pointer and index file, and the segment register file. The miscellaneous set consists 
of the instruction pointer, flag register, CAUSE register, OPCODE register, PIP 
register, TIMER register, HT1MER register, and BUFFERSIZE register. The 
register structures are described in the following paragraphs. 
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Table 7-9. Classes of Hardware Elements 



Class Name 


Hardware Elements 


general-register 

pointer-register 

index-register 

segment-register 

status-register 


16-bit work register 

16-bit address register 

16-bit address register 

16-bit segment reference register 

8- and 16-bit status registers 



General Register File. The RAX, RBX, RCX, and RDX registers compose the 
General Register File. These registers participate interchangeably in 8086 arithmetic 
and logical operations. These registers are assigned the following mnemonics: 

RAX: Accumulator 
RBX: Base Register 
RCX: Count Register 
RDX: Data Register 

The general registers are unique within the 8086 as their upper and lower bytes are 
individually addressable. Thus the general registers contain two 8-bit register files 
called the H file and L file as illustrated below: 





15 


HFile 

8 


L File 
7 0 


RAX: 


RAH 


RAL 


RBX: 


RBH 


RBL 


RCX: 


RCH 


RCL 


RDX: 


RDH 


RDL 



General Register File 



Pointer and Index Register File. The BP,SP,SI, and DI set of 16-bit registers is 
called the Pointer and Index Register File. The registers in this group are similar in 
that they generally contain offset addresses used for addressing within a segment. 
They can participate interchangeably in 16-bit arithmetic and logical operations. 
They are also used in address computation. The mnemonics associated with these 
registers are: 

SP: Stack Pointer 
BP: Base Pointer 
SI: Source Index 
DI: Destination Index 

The pointer and index registers are illustrated below: 



15 



SP: 
BP: 
SI: 
DI: 



Pointer and Index Register File 
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Segment Register File. The CS,DS,SS, and ES registers constitute the Segment 
Register File. These registers provide a significant function in the memory address- 
ing mechanisms of the 8086. They are similar in that they are used in all memory 
address computations. The mnemonics associated with these registers are: 

CS: Code Segment Register 
DS: Data Segment Register 
SS: Stack Segment Register 
ES: Extra Segment Register 

The contents of the CS register define the current code segment. All instruction 
fetches are taken to be relative to CS using the instruction pointer (IP) as an offset. 

The contents of the DS register define the current data segment. All data references 
except those involving BP,SP, or DI in a string instruction, are taken by default to 
be relative to DS. 

The contents of the SS register define the current stack segment. All data references 
which implicitly or explicitly involve SP or BP are taken by default to be relative 
toSS. 

The contents of the ES register define the current extra segment. The extra segment 
has no specific use, although it is usually treated as an additional data segment. 

The segment registers are illustrated below: 
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CS: 

DS: 

SS: 

ES: 



Segment Register File 



Status Register 

The instruction pointer, flag register, CAUSE register, OPCODE register, PIP 
register, TIMER register, HTIMER register, BUFFERSIZE register, UPPER 
register, and LOWER register constitute the status register set. These registers pro- 
vide a variety of functions to the emulator. These registers are assigned the following 
mnemonics: 

IP: Instruction Register 
RF: Flag Register 
CAUSE: CAUSE Register 
OPCODE: OPCODE Register 
PIP: Previous Instruction Register 
TIMER: TIMER Register 
HTIMER: HTIMER Register 
BUFFERSIZE: BUFFERSIZE Register 
UPPER: UPPER Register 
LOWER: LOWER Register 

The content of the IP register defines the offset to the CS register in instruction 
address computations. The Flag Register contains the status flag values. The 
CAUSE register is used to retain the cause of the last break in emulation. The 
OPCODE register stores the opcode fetched in the last instruction-fetch cycle in 
trace data. The Previous Instruction Register is used to store the displacement part 
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of the address of the last instruction-fetch in trace data. TIMER contains the low- 
order 16 bits of the 2-MHz timer indicating how long emulation has run (read only), 
HTIMER contains the high-order 16 bits of the timer (read only). BUFFERS1ZE 
contains the count (displayed in decimal only) of frames of valid trace data collected 
in the trace buffer (16 bit, read only). The UPPER register contains the highest 
available address in ICE-86A workspace below the symbol table. The LOWER 
register contains the lowest address available in ICE-86A workspace above the ICE 
software. 

The status registers are illustrated below: 
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IP 
RF; 
CAUSE: 
OPCODE: 
PIP: 
TIMER: 
HTIMER 
BUFFERSIZE 
UPPER 
LOWER 



Status Registers 



The Flag Register (RF) contains nine status values, each one a bit in length. The 
following mnemonics are assigned to each of the status values in the register: 

AFL: Auxiliary-carry 

CFL: Carry 

DFL: Direction 

IFL: Interrupt-enable 

OFL: Overflow 

PFL: Parity 

SFL: Sign 

TFL: Trap 

ZFL: Zero 

AFL is set if an instruction caused a carry out of bit 3 and into bit 4 of a resulting 
value. CFL is set if an instruction caused a carry or a borrow out of the high order 
bit. DFL controls the direction of the string manipulation instructions. IFL enables 
or disables external interrupts. OFL is used to denote an overflow condition in a 
signed arithmetic operation. SFL is used to indicate the sign of the result of an 
operation. TFL is used to place the processor in a single-step mode for program 
debugging. ZFL is used to indicate a zero valued result of an instruction. The posi- 
tion of the status bits in the RF Register are shown below: 
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Flag Registers 



7-64 



ICE-86A 



Interrogation and Utility Commands 



The CAUSE Register is used to store the cause for the last break in emulation. The 
byte returned by the "Read Break Cause'* nardware command contains the follow- 
ing bit values: if bit = 1, then the specified condition is true, otherwise false. Each bit 
has associated with it a message that is displayed if the bit is true when the software 
command, CAUSE, is entered. 



Bit Position Condition String 

0 Breakpoint 0 matched 'BRO' 

1 Breakpoint 1 matched 'BRV 

2 Both breakpoints matched sequentially 'SEQ' 

3 Guarded memory access occurred 'GUARD' 

4 User aborted processing 'ABORT' 

5 Timeout on user READY 'RDYTO' 

6 Timeout on user HOLD 'HLDTO' 

7 External Break 'EXTRN' 



BRO and BR1 occur when emulation is halted due to matching the condition set in 
the corresponding break register. Use of the breakpoint registers is discussed in 
Chapter 6. SEQ occurs when emulation is halted due to matching both breakpoint 
registers during the same instruction. For example, BRO can be set for the address of 
an instruction while BR1 is set for the value at that address, i.e., the instruction 
opcode. Then, when the specified instruction is fetched from the specified address, 
SEQ is the break condition displayed. GUARD occurs when memory that was not 
mapped is accessed. Memory mapping is discussed in Chapter 7. ABORT occurs 
when the user presses the escape key to halt emulation. RDYTO occurs when emula- 
tion is halted because of a ready timeout error. See Chapter 6 and Appendix B. 
HLDTO occurs when emulation is halted because of a hold timeout error. See 
Appendix B. EXTRN occurs when the user halts emulation through the external 
break line in the buffer box. See Chapter 1 for a description of this line. 



Pin References 

In addition to the status registers, the ICE-86A emulator provides access to eight 
8086 pins. The following mnemonics are assigned to reference the 8086 processor 
pins shown below: 



Mnemonic 


8086 Pin 


RDY 


READY 


NMI 


NMI 


TEST 


TEST 


HOLD 


HOLD 


RST 


RESET 


MN 


MN/MX 


IR 


INTR. 


RQGT, BUS 


RQ/GTO, RQ/GT1 (HOLD, HLDA) 



General Formats for Numeric Values 

The 1CE-86A emulator displays numeric values in a variety of formats depending 
upon the type of the numeric value. Table 7-10 defines the display formats for each 
of the non-real numeric types. 
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Table 7-10. Numeric Value Display Formats 



Type 


Class Name 


Definition 


BYTE 


byte 


An 8-bit value displayed in the current base. 


SINTEGER 


sinteger 


sign byte-number (short integer number) 


WORD 


word 


A 16-bit value displayed in the current base. 


INTEGER 


integer 


sign word 




sign 


+ ::- 




bit 


0::1 


POINTER 


pointer 


base : displacement H 




base 


4 hexadecimal digits (the base value of pointer) 




displacement 


4 hexadecimal digits (the displacement value of pointer) 



If the high order bit of an INTEGER or SINTEGER is 1 , the numeric value is com- 
plemented and the sign is set negative ("-"). For example, FFH is displayed as 
-01H as SINTEGER and F000H is displayed as -0FFFH as INTEGER. 



In base ASCII, a pair of apostrophes enclose a single character in the case of a byte 
value or encloses two characters if a word value is to be displayed. In the case of a 
word, the high order byte appears on the left of the character pair. 

In the four numeric bases, the BYTE and WORD values have a suffix and sufficient 
leading zeroes to contain the following number of digits. 

Hexadecimal Decimal Octal Binary 

BYTE 2 3 3 8 

WORD 4 5 6 16 



The real numeric types are REAL, DREAL, and TREAL. In general, these types 
share the same characteristics. Any real value is entered in decimal base (no matter 
what the current base is), may be preceded by a sign, and must consist of at least a 
single digit followed by a decimal point. The decimal point may be followed, in 
order, by several more digits, the letter E (flagging the start of an exponent), a sign, 
and a few more digits representing the magnitude of the exponent. Signs are 
optional; their absence is interpreted as meaning a positive value. Exponent digits 
cannot be entered without the letter E preceding them, and the letter E cannot be 
entered without at least one digit preceding it and one digit directly following it. 

Examples: 

*REA100H = 2., 52., 124341 .23E27, -1.2307, + 4.001 172E-25, 123243.0E12 

The display of real values follows the same rules as their entry, with the added 
restrictions that only one digit precedes the decimal point, the maximum allowable 
number of digits directly follows the decimal point, and there is always a signed 
exponent value. 
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* REM 00 LEN6 

REA 0000:0100H=+2.00000000E+0 +5.20000000E+1 

REA 0000:0108H=+1 .24341231 E+32 -1 .23070002E+0 

REA 0000:0110H=+4.00117203E-25 +1.23243004E+17 

The real numeric types differ both in the precision and the magnitude of the absolute 
values they may represent. The maximum number of digits that may surround the 
decimal point and follow the letter E varies for each of the real types. Their format is 
displayed below: 

REAL s <sign> <digit> . Keight digits> E <sign> <two digits> 
DREAL = <sign> <digit> . Ksixteen digits> E <sign> Kthree digits> 
TREAL = <sign> <digit> . Kseventeen digits> E <s/gn> <fourdigits> 

The minimum positive and negative values (the values closest to zero) and the max- 
imum positive and negative values (the values closest to infinity) are shown in the 
chart below in normalized form: 

Minimum Positive and Negative Values Maximum Positive and Negative Values 

REAL ±1 .17549435E-38 ±3.40282347E + 38 

DREAL ±2.225073858507201 4E-308 ±1 .7976931 3486231 57E + 308 

TREAL ±3.3621 031 431 1 209351 E-4932 ±1 .1 89731 495357231 76E + 4932 

If the maximum values (positive or negative) are exceeded, an overflow error 
message is displayed: 

ERR BF.REAL NUMBER OVERFLOW 

However, if the minimum values (positive or negative) are exceeded, no error 
message is displayed and the value 0 is used. 

NOTE 

The 1CE-86A emulator does not support expressions containing real values. 
While real values may be entered into memory or displayed from memory, 
no arithmetic can be performed involving them. 

The Display Processor and Status Register Command allows you to display any of 
the 8-bit and 16-bit registers, the status flags and 8086 pin values. All referenced 
items are displayed on one line separated by spaces. However, if any displayed value 
would extend beyond column 80, a new line of display is initiated. Each reference is 
displayed according to the appropriate format shown below. The names are trun- 
cated to three characters. 

8-bit-register-name = byte 

16-bit-register-name = word 

status-flag-name = bit 

pin-name = bit 

Example 1 : 

*RAX, RBH, SP, CAUSE, AFL, HTIMER, BUFFERSIZE 
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Display: 

RAX=0001H RBH=2FH SP=FFE7H CAU=NONE AFL-1 HTI=008EH BUF=D1A2H2H 
Example 2: 

*REGISTER 
Display: 

RAX=0000H RBX=00A2H RCX=0001H RDX=0010H SP=000AH BP=0Q00H SI-0123H DI=0000H 
CS=0000H DS=FF1EH SS=0000H ES=0000H RF=0000H IP=FABCH 

Example 3: 

FLAG 

Display: 

CLF=0 PFL=0 AFL=0 ZFL=0 SFL=0 TFL=1 IFL=0 DFL=0 OFL=0 
Example 4: 

PIN 
Display: 

RDY=1 NMI=0 TES=1 HOL=0 RST=0 MN=1 IR=0 
Example 5: 

UPPER 
Display: 

UPP = F680H 

In the case of the CAUSE register, the appropriate messages are displayed instead of 
the actual value stored in the register. (If CAUSE is typed prior to running emula- 
tion, then the string ^ONE' is returned.) No more than one string can be displayed 
at any given time (there can be only one cause for emulation halt at any given time). 

Examples: 

CAUSE 

CAU=NONE 

GO 

EMULATION BEGUN <esc> 

EMULATION TERMINATED, CS:IP = <XXXX>+<XXXX>H 

CAUSE 

CAU=ABORT 

The CAUSE register, however, can still be used as part of expressions; in this con- 
text, the actual value stored in the CAUSE register is accessed. 

Examples: 

CAU 

CAU=ABORT 
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.TEST=CAU+0010H 
.TEST 

.TEST=0020H 



The Display Memory command enables you to display a range of one or more 
memory locations. When displaying memory, the format of the display depends 
upon the memory type, given either explicitly by a mem-type or implicity by the type 
of a symbol in a typed-memory-reference. For example, suppose that ten con- 
secutive bytes of memory contain A5H, 81 H, 34H, OCOH, 15H, OFFH, 77H, 86H, 
45H, and 54H. The following are sample outputs in each of the four bases: hexa- 
decimal, decimal, octal and binary: 



Memory 


Hexadecimal 


Decimal 


Octal 


Binary 


Type 










BYTE 


ASH 


165T 


245Q 


101 001 01 Y 


WORD 


81 ASH 


331 89T 


1 00645 Q 


10000001 101 001 01 Y 


SINTEGER 


-5BH 


-91 T 


-133Q 


-01 011 01 1Y 


INTEGER 


-7E5BH 


-32347T 


-771 33 Q 


-01111 11001011011 Y 


POINTER 


C034:81A5H 








REAL 




-2.82041 287E+0 






DREAL 




-1 .6921176799917261 E-277 






TREAL 




+2.32856759329006744E+1562 







In addition to displaying real numeric values, there are three character strings that 
may be displayed for real values under special circumstances. These are "++," 
" — and which refer, respectively, to positive infinity, negative infinity, and 
not a number (NAN). 

The user cannot enter these character symbols (++, — , and ..) directly as values for 
real numbers. However, infinity can be entered indirectly by typing the byte value of 
the representation of a floating point number that overflows the intended real 
numeric data type. The following examples illustrate how this can be done when 
REAL is the intended data type. The overflow value can be entered with the BYTE 
command. 



*BYTE 0 = 0,0,80,7F 
*REAL 

REA 0000:0000H=++ 



The result in this case is positive infinity. 

*BYTE 0003H=0FFH 
*REAL 

REAL0000:0000H=— 



Changing the MSB to OFFH changes the sign to produce negative infinity. 

*BYTE 0OOOH=0FFH, OFFH, OFFH, OFFH 
*REAL 

REA0000:0000H= . 

Storing binary 1 in all four bytes results in NAN or not a number. 

Usually, these conditions occur when the 8087 NDP is used with the 8086. The 
8087 may return infinity as the overflow result of a computation or as the result 
of a divide by zero computation. A NAN may be generated by the 8087 as an 
indefinite result, for example, when an uninitialized variable is detected. 
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These data types are discussed in detail in The 8086 Family User's Manual 
Numerics Supplement, Manual Order Number 121586. Further information on 
real data-type memory storage is also available in "Set Memory and Port Con- 
tent Commands" in Chapter 7. 

The Display memory command permits you to display more than one line of 
memory values. Each line of display contains the memory address of the first value 
displayed on that line followed by a maximum number of values as indicated by 
table 7-11. 



Table 7-11. Display Values Per Line 





Hexadecimal 


Decimal 


Octal 


Binary 


ASCII 


BYTE 


16 


8 


8 


4 


64 


WORD 


8 


8 


8 


2 


32 


SINTEGER 


8 


8 


8 


4 


32 


INTEGER 


8 


8 


4 


2 


16 


POINTER 


4 


+ 


+ 


+ 


+ 



Table 7-1 refers only to non-real memory types. Real memory types— REAL, 
DREAL, and TREAL — display only in decimal base and always display a maximum 
of two values per line. 



REAL, DREAL, and TREAL values can be accessed and modified independent of 
the present base; BASE = T is always implied for REALs. 

Following are examples of memory display in all four bases. As displays of real 
numeric type memory will always appear in decimal format, no matter what the cur- 
rent base is, examples of REAL, DREAL, and TREAL will be given only in the sec- 
tion where BASE=T; this is not meant to imply that real values cannot be accessed 
when BASE is not set to T. 

Assume that the following memory locations contain the values shown below (in 
hexadecimal): 

Address Content 

00000H 00H 41H 42H 43H 45H 20H 30H 3DH 74H 68H 65H 72H 20H 43H 61H 6CH 

00010H 69H 66H 6FH 72H 6EH 69H 61 H ODH OAH 20H 20H 20H 20H 20H 20H 20H 

00020H 20H 20H 20H 6CH61H 77H 20H 70H 72H 6FH 76H 69H 64H 65H 64H 20H 

00030H 66H 6FH 72H 20H 70H 72H 6FH 67H 72H 61 H 6DH 73H 20H 6FH 66H 20H 

00040H 74H 68H 69H 73H 20H 73H 6FH 72H 74H 2EH 20H 20H 54H 68H 69H 73H 



The following commands display the above memory values with BASE = H: 
Example 1: 

BYTE 0000:0030 
Display: 

BYT 0000:0030H=66H 
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Example 2: 

BYT0:30TO0:3F 
Display: 

BYT0000:0030H=66H 6FH 72H 20H 70H 72H 6FH 67H 72H 61 H 6DH 73H 20H 6FH 66H 20H 
Example 3: 

WORD 0000:30 
Display: 

WOR0000:0030H=6F66H 
Example 4: 

WOR0:30 LEN10H 
Display: 

WOR 0000:0030H=6F66H 2072H 7270H 676FH 6172H 736DH 6F20H 2066H 
WOR 0000:0040H=6874H 7369H 7320H 726FH 2E74H 2020H 6854H 7369H 

Example 5: 

POINTER 0:30 
Display: 

POI 0000:0030H=2072:6F66H 
Example 6: 

POI0:30TO0:3C 
Display: 

POI 0000:0030H=2072:6F66H 676F:7270 736D.6172H 2066:6F20H 
Example?: 

POI 0:30 TO 0:50 
Display: 

POI0000:0030H=2072:6F66H 676F:7270H 736D.6172H 2066:6F20H 
POI 0000 : 0040 H =7369: 6874 H 726F.7320H 2020:2E74H 7369:6854H 
POI 0000:0050H=756F:6420H 

The following examples illustrate display in decimal (BASE=T): 

Example 8: 

BYTE 0000:0030 
Display: 

BYT0000:0030H=102T 
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Example 9: 

BYT 0:30 TO0:3F 
Display: 

BYT 0000:0030H=102T 11 IT 114T 032T 112T 114T 11T 103T 
BYT 0000:0040H=114T 097T 109T 115T 032T 111T 102T 032T 

Example 10: 

WORD 0:30 
Display: 

WOR0000:0030H=28518T 
Example 1 1 : 

WORD 00:30 TO 00:4E 
Display: 

WOR 0000:0030H=28518T 08306T 29296T 26479T 24946T 29549T 28448T 08294T 
WOR 0000:0040H=26740T 29545T 29472T 29295T 11892T 08224T 26708T 29545T 

Example 12: 

POINTER 0:30 
Display: 

POI 0000:0030H=2072:6F66H 
Example 13: 

POINTER 0:30 TO 0:3C 
Display: 

(same as Example 6.) 
Example 14: 

REAL 0:30 
Display: 

REA 0000:0030H=+2.05350560E-19 
Example 15: 

REAL 0:30 TO 0:3F 

Display: 

REA 0000:0030H=+2.05350560E-19 
REA 0000:0038H=+1 .88072324E+31 



+1.13075659E+24 
+1.95185260E-19 
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'D REAL .0:30 TO 0:3F 
Display: 

DRE 0000:0030H=+1 .7514059685946888E+190 

Example 17: 

TREAL0:30TO0:3F 
Display: 

TRE 0000:0030H=+0. 423947274021 42709E+2578 
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+1.3385686327532207E-152 



+0.1 1708909595879081 E+3963 



The following examples illustrate memory displays in octal (BASE=Q). 
Example 18: 

BYTE 0000:0030 
Display: 

BYTO00O:0O30H=146Q 
Example 19: 

BYT 0:30 LEN 10H 
Display: 

BYT 0000:0030H=146Q 157Q 162Q 040Q 160Q 162Q 57Q 147Q 
BYT0000:0040H=162Q 141Q 155Q 163Q 040Q 157Q 146Q 040Q 

Example 20: 

WOR 0:30 
Display: 

WOR 0000:0030H=067546Q 
Example 21: 

WORD 0:30 LEN 10H 
Display: 

WOR 0000:0030H=067546Q 020162Q 071160Q 063557Q 
WOR0000:0038H=060562Q 071555Q 067440Q 0201 46Q 
WOR 0000:0040H=064164Q 071 551 Q 071440Q 071157Q 
WOR0000:0048H=027164Q 020040Q 064124Q 071551Q 

Example 22: 

POINTER 0:30 LEN 0D 
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Display: 

(same as Example 6.) 

The following examples illustrate memory displays in binary (BASE=Y). 
Example 23: 

BYTE 0:30 
Display: 

BYTO000:003OH=0110010Y 
Example 24: 

BYTE 0:30 TO 0:3F 
Display: 

BYT0000:0030H=01100110Y 01101111 Y 01110010Y 00100000Y 
BYT0000:0034H=0111Q000Y 01110010Y 01101111 Y 01100111 Y 
BYT0000:0038H=01110010Y 01100001 Y 01101101 Y 01110011 Y 
BYT0000:003CH=00100000Y 01101111Y 01100110Y 00100000Y 

Example 25: 

WOR 0:30 
Display: 

WOR 0000:0030H=01 1 01 1 1 1 01 1 001 1 0Y 
Example 26: 

WOR 0:30 LEN10H 

Display: 

WOR 0000:Q030H: 
WORQ000:0034H= 
WOR0000:0038H= 
WOR 0000:003CH 
WOR0000:0040H= 
WOR 0000:00441+ 
WOR 0000:0048H= 
WOR 0000:004CH 

Example 27: 

POINTER 0:30 

Display: 

POI 0000:0030H=2072:6F66H (Always displayed in hexadecimal.) 

The Display I/O command enables you to display byte ports (PORT) and word 
ports (WPORT) in a manner similar to the Display memory command. Single port 
contents or the contents of a range of ports may be displayed. However, only a 



=01 1 01 1 1 1 01 1 001 1 0Y 001 0000001 11 001 0 Y 
=01 11 001 001 11 0000 Y 0110011101101111 Y 
=01 100001 01 11 001 0Y 0111001101101101 Y 
=01 1 01 1 1 1 001 00000 Y 001 0000001 1 001 1 0 Y 
=01 1 01 00001 1 1 01 00Y 01 1 1 001 1 01 1 01 001 Y 
=01 1 1 001 1 001 00000 Y 01 1 1 001 001 1 01 1 1 1 Y 
=001 01 1 1 001 1 1 01 00 Y 001 00000001 00000 Y 
=01 1 01 00001 01 01 00 Y 01 1 1 001 1 01 1 01 001 Y 
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single integer is required to specify the port address. The following examples 
illustrate the Display I/O command. The implied suffix in these examples is H 
(hexadecimal) for address specification. 

Example 1 : 

BASE = Y 
PORT120H 

Display: 

POR0129H=10111111Y 
Example 2: 

PORT 120 LEN10 
Display: 

POR0120H=10111111Y 10111111 Y 10111111Y 01111111 Y 
POR0124H=10111111Y 10111111Y 10111111Y 01111111Y 
POR0128H=10111111Y 10111111Y 10111111Y 01111111 Y 
POR012CH=10111111Y 10111111Y 10111111Y 01111111Y 

Example 3: 

BASE = Q 
PORT 120 

Display: 

POR0120H=277Q 
Example 4: 

PORT 120 TO 12F 
Display: 

POR0120H=227Q 177Q 277Q 177Q 277Q 177Q 277Q 177Q 
POR0128H=277Q 177Q 277Q 177Q 277Q 177Q 277Q 177Q 

Example 5: 

BASE =T 
POR120 

Display: 

POR0120H=191T 
Example 6: 

PORT 120 TO 12F 
Display: 

POR0120H=191T 127T 191T 127T 191T 127T 191T 27T 
POR0128H=191T 127T 191T 127T 191T 127T 191T 127T 
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BASE = H 
PORT 120 

Display: 

POR0120H=BFH 
Example 8: 

PORT 120 TO 12F 
Display: 

POR0120H=BFH 7FH BFH 7FH BFH 7FH BFH 7FH BFH 7FH BFH 7FH BFH 7FH BFH 7FH 

Example 9: 

BASE = Y 
WPORT 120 

Display: 

WPO 01 20H=01 1 1 1 01 1 1 01 1 1 1 1 1 Y 
Example 10: 

WPORT 120 T012E 
Display: 

WPO 01 20H=01 1 1 10111 01 1 1 1 11 Y 01 1 1 1 1 1 1 1 01 1 11 11 Y 

WPO0124H=0111111110111111Y 0111101110111111 Y 

WPO 01 28H=01 1 1 1 1 1 11 01 1 11 11 Y 01 11 1 01 1101 111 1 1 Y 
WPO 01 2CH =01 1 1 1 01 1 1 01 1 1 11 1 Y 01 1 1 1 01 11 0111 1 1 1 Y 

Example 11: 

BASE = Q 
WPORT 120 

Display: 

WPO 01 20 H =0776770 
Example 12: 

WPORT 120 TO 13E 
Display: 

WPO0120H=077677Q 077677Q 077677Q 075677Q 075677Q 077677Q 075677Q 077677Q 
WPO0130H=077677Q 077677Q 075677Q 077677Q 075677Q 077677Q 077677Q 075677Q 

Example 13: 

BASE = T 
WPORT 120 
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Display: 

WPO 0120H=32703T 
Example 14: 

WPORT120 T013E 
Display: 

WPO0120H=32703T 32703T 32703T 31679T 31679T 32703T 31679T 32703T 
WPO0130H=32703T 32703T 31679T 32703T 31679T 32703T 32703T 31679T 

Example 15: 

BASE = H 
WPORT120 

Display: 

WPO 0120H=7FBFH 
Example 16: 

WPORT120 T013E 
Display: 

WPO0120H=7FBFH 7FBFH 7FBFH 7BBFH 7BBFH 7FBFH 7BBFH 7FBFH 
WPO0130H=7FBFH 7FBFH 7BBFH 7FBFH 7BBFH 7FBFH 7FBFH 7BBFH 

The Display STACK causes the top n words of the user's stack (i.e., user memory 
pointed at by SS:SP) where n is an integer value in the command that specifies the 
number words in the stack to be displayed. 

Example: 

STACK 10 

Display: 

WOR0000:0000H=4100H 4342H 2045H 3D30H 6874H 265H 4320H 6C61H 
WOR 0000:001 0H=6669H 726FH 696EH 0D61H 200AH 2020H 2020H 2020H 

The Display Boolean command is used to display the boolean value of an integer 
value contained in the command: 

Example: 

BOOL FFH 
Display: 

TRUE 
Example: 

BOOL!X = !Y 
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Display: 
FALSE 

The Display NESTING Command 

The Display NESTING command enables you to display the starting and return 
addresses of all procedures that are currently active. The user is scanned for pro- 
cedure starting and return addresses as follows (all references to stack manipulations 
are restricted to the scope of the nesting module only): 

1. Setb = CS 

2. Set d = SP (word at the top of the user stack). If the 5 bytes from (b,d-5) 
through (b,d-l) can be interpreted as a short call (direct or indirect) (2,3, or 4 
bytes), then b,d is assumed to be a return address. 

3. Set WORD temp$b:d = next word on the user stack. If the 5 bytes from 
(temp$b-d) through (temp$b,d-l) can be interpreted as a long call (direct or 
indirect) (2,3,4 or 5 bytes), INT (1 or 2 bytes), or INTO, then b,d (and the next 
word in the stack for INT and INTO) can be assumed to be a return address. 

4. The return address, type of call (i.e., short call direct), INT, or INTO, and the 
starting address (for direct only) are displayed. 

The above procedure is repeated until 16 iterations fail to find a return address or 
the stack memory enters guarded memory. Care should be taken in using this com- 
mand as the above method is susceptible to error. 



The EVALUATE Command 

The EVALUATE command handles the arithmetic computation involved in 
translating integers from one radix to another and computes the 20-bit address of a 
pointer. This command has the form EVALUATE expr, where expr is any numeric 
constant or numeric expression. The expr can also be a predefined reference 
keyword such as UPPER or LOWER, or it can be an expression containing 
reference keywords. Upon receiving this command, the ICE-86A emulator evaluates 
any expression to a single number. If it is an integer, it displays the result in the four 
bases Y, Q, T, and H, and the corresponding ASCII characters, all on one line. For 
ASCII, the characters are enclosed in single quotes ('); printing characters are 
displayed (ASCII codes 20H through 7EH after bit 7 is masked off), while non- 
printing characters are suppressed. 

When the EVALUATE command is followed by the keyword 'SYMBOLICALLY' 
(preceding the carriage return), the numeric value output by the command is 
displayed as a symbol or statement number plus a remainder. The ICE-86A symbols 
and statement numbers are searched to find the one with the same base whose value 
is closest to but not greater than the value being output. In the event that a symbol 
and a statement number have the same value, the symbol is used. The value is then 
displayed as either the selected symbol plus a numeric-constant or the selected state- 
ment number plus a numeric-constant, where the numeric-constant is the remainder 
in the current output base. If no symbol or statement number has a value less than 
or equal to the number being output, the value is output as a numeric-constant. If 
the remainder is zero, the numeric constant is omitted. 

If the numeric expression has a non-zero base, the value is displayed as a pointer 
(base:disp). 

Here are several examples of the use of the EVALUATE command, with the display 
produced by each one. 



7-78 



ICE-86A 



Interrogation and Utility Commands 



Example 1 : 

EVALUATE 123T 
Display: 

1111011 Y 173Q 123T7BH '[' 

Example 2: 

EVA FFH + 256T 

Display: 

111111111Y 777Q 511T 1FFH " 

Note that the addition was performed first, then the result was displayed in the four 
bases. The result contained only non-printing ASCII characters, displayed as empty 
quotes. 

Example 3: 

EVA111:0222H SYMBOLICALLY 
Display: 

0111:0222H 

This example assumes that no symbol or statement number match. 
Example 4: 

EVA111:222H SYM 
Display: 

..MOD1.SAM + 0021 H 

This example assumes that a matching symbol with an address at 111:201 has been 
selected. 

Example 5: 

EVA UPPER-LOWER 

Display: 

1101100010111Y 154240Q 6935T 1817H() 

This command will display the difference between UPPER and LOWER, which will 
be the total memory available for symbols and macro expansion. The display will be 
in all bases. 

NOTE 

The EVALUATE command does not process real values. That is, real 
numbers in decimal base cannot be translated by the 1CE-86A emulator into 
binary, octal, or hexadecimal, or corresponding ASCII characters. 
Attempting to evaluate a real number produces an error message. 
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The Disassembly Command 

The Disassembly Command allows the user to display instructions in memory in 
disassembled format. (See Display of Trace Data in Instruction Mode, Chapter 6, 
for definition of format.) The syntax of the command appears below: 

DASM address Pro address 1 
[LENGTH length] 

The user may specify a single address, or a partition of addresses, to be dis- 
assembled and displayed. 



The DEFINE DASM Command 

The DEFINE DASM Command is intended to support disassembly of opcodes nor- 
mally executed by an 8087 Numeric Data Processor. The command alerts the 
ICE-86A disassembler to the hardware/software configuration of the user prototype 
application system as it impacts floating point instruction handling. The syntax of 
the command is given below: 



DEFINE DASM 



86 
87 

EMULATOR 



Initially, DASM is set to "86"; this indicates to the disassembler that no special 
floating point hardware or software exists with the 8086 processor, i.e., no special 
interpretation of 8086 ESCape or INTerrupt instructions is required of the 
disassembler in this setting. If the user combines an 8087 NDP with the 8086 CPU, 
then DASM should be defined as ' '87"; the disassembler then interprets ESCape 
instructions as floating point instructions. If the user combines the 8087 emulator 
software package with the 8086 CPU, then DASM should be defined as 
"EMULATOR"; the disassembler then interprets INTerrupt instructions as 
floating point instructions. 



NOTE 

The operator should not display trace when TRA=INS while DASM is 
defined as "EMULATOR" (i.e., the user's application system is based on 
an 8086 CPU in local mode with the software emulator for the 8087 NDP). 
The trace facility is not capable of interpreting INTerrupt instructions prop- 
erly in this system configuration. That is, when the trace buffer is 
disassembled, it will show that an FP instruction has been executed but the 
operand values will be wrong and the trace will be out of synchronization 
with the actual instruction stream which can be misleading to the user. 



The user should also be aware that when DASM is defined as "87" (i.e., the 
user's application system is based on an 8086 CPU in local mode with the 
harware 8087 NDP), then the trace facility will not record bus activities 
while the 8087 NDP controls the system bus. (As a general principle, the 
trace facility is incapable of recording bus activities whenever a device other 
than the ICE-86A emulator controls the system bus.) 
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Display Processor and Status Registers Command 



t reference preference]... y 
REGISTER 
FLAG 
PIN 

Examples: 

UPPER 
RAX 

RBH, SI, AFL, HOL 
REGISTER 
R 

FLA 
PIN 
BUS 

reference 



REGISTER 



FLAG 



PIN 



Any of the reference keywords that reference processor registers, 
status registers, and pins. Also can include memory and I/O in list. 

A command keyword requesting the display of the thirteen 16-bit 
8086 registers and RF. 

A command keyword requesting the display of the nine status 
flags. 

A command keyword requesting the display of the contents of the 
seven input pins. 
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Display Memory Command 

memory-designa tor address |TO address 

[J-ENGTH length 

Examples: 

BYTE 1 000:1 00H 
WOR 0:123 TO 0:200 
SIN 100:0 LENGTH 200 
INT 200:200 
POINTER 200:200 
POI 200:200 TO 200:2FE 



] 



memory-designator 



address 



TO 



LENGTH 



length 



One of the following keywords that specify the size and type 
of memory referenced: 

BYTE A 1 -byte (8-bit) integer value. 

WORD A 2-byte (16-bit) integer value. 

SINTEGER A 1 -byte (8-bit) short integer number. 

INTEGER A 2-byte (16-bit) integer value. 

POINTER A 4-byte (two 16-bit integer) value. 

REAL A 4-byte (32-bit real) value. 

DREAL An 8-byte (64-bit real) value. 

TREAL A 10-byte (80-bit real) value. 

A pointer value containing a base and a displacement that 
together specify an address of a memory location. 

A partition keyword that denotes that an address is to follow. 
This address defines the upper bound of the required range of 
addresses in the partition. 

A partition keyword that denotes that a length value is to 
follow. 

An integer value specifying the number of addresses to be 
contained in the partition (bytes, words or pairs of words, 
depending on memory-designator ). 
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Display I/O Command 

(PORT I address 
WPORT j 



[TO address I 
LENGTH length] 



Examples: 



PORT FF12H 
POR FFOO TO FFFF 
POR1000 LEN 200 
WPORT 123H 
WPO100TO 200 
WPO100 LENGTH 101 



PORT 
WPORT 

address 
TO 

LENGTH 



Keyword reference to 8086 8-bit I/O port(s). 

Keyword reference to 8086 16-bit I/O port(s). 

An integer value that specifies the address of an 8086 port. 

A partition keyword that denotes that an address is to follow. 
This address defines the upper bound of the required range of 
port addresses in the partition . 

A partition keyword that denotes that a length value is to 
follow. 



length 



An integer value specifying the number of port addresses 
(byte or word ports) to be contained in the partition. 
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Display STACK Command 

STACK expression 

STACK 1 0H 
STA .SAM 
STACK .SAM + 20 

STACK A command keyword that requests the display of the contents of 

the user's stack. The stack is located in user memory referenced by 
the pointer value SS:SP. 

expression An integer expression. The value of this expression defines the 
number of words at the top of the STACK that are to be displayed. 
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Display Boolean Command 

BOOL expression 
Examples: 
BOOLFFH 

BOO CS=DS AND IP > 50 
BOO BYTE .X = F2H 
BOOL ISAM 
B002CFL 

BOOL A command keyword requesting the display of the boolean value 

(TRUE, FALSE) of the input value, expression . 

expression A boolean expression. The value of this expression is evaluated to a 
boolean value. If the least significant bit of the expression = 1, the 
boolean value is TRUE, otherwise the boolean value is FALSE. 
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Display NESTING Command 

NESTING 
Example: 
NESTING 



NESTING A command keyword that causes the display of each CALL, INT, 

and INTO instruction that is currently active. 
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EVALUATE Command 

EVALUATE numeric-expression [SYMBOLICALLY] 

Examples: 

EVALUATE UPPER-LOWER 

EVALUATE 123T 

EVALUATE 4142H 

EVALUATE FFH + 256T 

EVALUATE A command keyword that directs the ICE-86A emulator to 
evaluate the expression and display the result in all four number 
bases and ASCII. 



numeric A numeric expression, numeric constant, predefined reference 

expression keyword, or an expression containing such a keyword. 

SYMBOLICALLY This keyword causes each numeric value output by the command to 
be displayed as a symbol or source statement number plus a 
remainder. The ICE-86A symbols and source statement numbers 
are searched for the one with the same base whose value is closest to 
but not greater than the value being output. In case a symbol and a 
statement number have the same value, the symbol is used. The 
value is then displayed as either a symbolic reference plus a numeric 
constant or a source statement number plus a numeric constant 
where the numeric constant is the remainder in the current output 
base. If no symbol or statement number has a value less than or 
equal to the number being output, then the value is output as a 
numeric constant. If the remainder is zero, the numeric constant is 
omitted. 
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Disassembly Command 

DASM address Fro address j 
[LENGTH length] 

Examples: 

DASM 1000:123 

DASM 1000:123 T0 1000:400 

DASM 2000:0000 LEN 100 



DASM 



A command keyword specifying the display of instructions in 
disassembled format. 



address A pointer value containing a base and displacement that together 

specify an address of a memory location. 

TO A partition keyword that denotes that an address is to follow. This 

address defines the upper bound of the required range of addresses 
in the partition. 

LENGTH A partition keyword that denotes that a length value is to follow. 

length An integer value specifying the number of addresses to be 

contained in the partition (bytes* several bytes in succession, words, 
or pairs of words, depending on memory type). 
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Interrogation and Utility Commands 



DEFINE DASM Command 



DEFINE DASM (86 
87 

I EMULATOR 

Examples: 



DEFINE DASM 86 
DEF DASM 87 
DEFDASM EMULATOR 



DEFINE Command keyword that informs the ICE-86A emulator that the 

value of the following facility is to be set. 



DASM 
86 



Command keyword that indicates the mode of disassembly. 

Indicates that the user's application system consists of an 8086 
processor without hardware or software support of floating point 
arithmetic. 



87 Indicates that the user's application system consists of an 8086 

processor in local configuration with an 8087 NDP. 

EMULATOR Indicates that the user's application system consists of an 8086 
processor equipped with the software package that emulates the 
8087 NDP. 
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CHAPTER 8 
ICE-86A™ ENHANCEMENTS 



The command features described in this chapter enhance the operation of the 
ICE-86A emulator by extending the power of the simple ICE-86A commands. 

ICE-86A emulator enhancements are of two kinds: compound commands and 
macro commands. These features are as follows. 

Compound commands 

REPEAT command 
COUNT command 
IF command 

Macro commands 

DEFINE MACRO command 

Invoke macro command 

Display macro command 

ENABLE/DISABLE EXPANSION command 

Macro directory command 

REMOVE MACRO command 

PUT MACRO command 

Please note that the examples in this chapter are independent of each other. The 
introduction to each example gives the initial conditions for that example, and does 
not assume any results or conditions from any previous examples. 



Compound Commands 

A compound command is a control structure that contains zero or more commands. 
The compound commands discussed in this chapter are the REPEAT, COUNT, and 
IF commands; the DEFINE MACRO command is also a type of compound com- 
mand. As the command titles indicate, REPEAT and COUNT are looping com- 
mands, and IF establishes conditional execution, and DEFINE MACRO establishes 
a named command block. All compound commands can have a "local" setting for 
the default SUFFIX (console input radix), as described under Local and Global 
Defaults in this chapter. 

REPEAT Command 

The REPEAT command executes zero or more ICE commands in a loop; the loop 
can also contain zero or more logical conditions for termination. 

The REPEAT command consists of the REPEAT keyword, zero or more com- 
mands of any type, zero or more exit conditions using WHILE or UNTIL, and the 
keyword END. Enter each of these elements on its own line of the console display; 
terminate each input line with an intermediate carriage return (shown as cr in the 
command syntax). The syntax for REPEAT can be shown as follows: 

REPEATcr 

[command cr 
WHILE boolean-expression cr 
UNTIL boolean-expression cr 
END 
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After each intermediate carriage return, the ICE emulator begins the next line with a 
period (giving an indented appearance), then the asterisk prompt to signal readiness 
to accept the next element. After the END keyword, enter a final carriage return to 
begin the sequence of execution. The final carriage return after END is not shown in 
the syntax, since all commands terminate with a final carriage return. The END 
keyword can be entered as ENDR or ENDREPEAT; the characters after END serve 
as a form of "comment" to indicate which loop is being terminated. 

The elements to be repeated are shown in brackets in the syntax. Each element can 
be a command, a WHILE clause, or an UNTIL clause. You can mix these elements 
in any order, using any number of each type of element. 

Each command is executed when it is encountered on each iteration. After the com- 
mand has been completely executed, the loop proceeds to the next element. 

The WHILE and UNTIL keywords introduce exit clauses. The WHILE clause ter- 
minates execution of the loop when its boolean-expression evaluates FALSE. The 
UNTIL clause terminates the loop when its boolean-expression evaluates TRUE. 

In both the WHILE and UNTIL clauses, the boolean-expression is evaluated each 
time the clause is encountered; that is, once per iteration. Evaluation at each itera- 
tion involves looking up the values of any references in the expression. Thus, the 
result can change with each evaluation. Refer to Chapter 5 for an explanation of 
how expressions are evaluated. 

The choice of WHILE or UNTIL is usually a matter of convenience — there is always 
a way to convert one into the other. For example, "WHILE bool-expr" is 
equivalent to "UNTIL NOT (bool-expr)". 

NOTE 

To terminate execution of a REPEAT (or COUNT) loop, press the ESC key 
at the console. The ICE command currently executing halts wherever it hap- 
pens to be; if you are emulating, the current instruction is completed before 
the break. The ICE emulator responds to the ESC with the asterisk prompt. 

Here are some brief examples of the REPEAT command. 



Example I : Generate an ASCII table similar to Table 5-2. 

DEFINE .TEMP = 40H 
REPEAT 

WHILE .TEMP <= 7EH 

EVALUATE TEMP 

TEMP =. TEMP + 1 
ENDR 



Example 2: Single-step through the user program and display the trace data col- 
lected for each instruction until a repetitious routine (.DELAY) is reached. 

TRACE = INSTRUCTIONS 
CS = SEG .START 
IP = OFF .START 
REPEAT 

UNTIL CS: IP = .DELAY 

STEP 

PRINT -1 
ENDR 
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Example 3: Using a complex combination of conditions in the boolean expression. 
REPEAT 

UNTIL (CS:IP > .END XOR !VAR1 = 0) AND (.TEMP > 0 XOR !VAR2 = 1) 
STEP 
REGISTER 
ENDR 

Example 4: Emulate from the start of the program (.START) until a breakpoint 
(.END EXECUTED) is reached, display status registers, then continue emulating, 
halting, and displaying status until a terminating condition (BYTE .VAR = 2) is 
reached. 

CS = SEG .START 
IP = OFF .START 
REPEAT 

GO TILL. END EXECUTED 

REGISTER 

UNTIL!VAR = 2 
ENDR 



COUNT Command 

Like REPEAT, the COUNT command sets up a loop. In addition to the WHILE 
and UNTIL clauses discussed under REPEAT, COUNT includes a loop counter that 
terminates the loop if no exit condition is met before the counter runs out. 

The COUNT command has the form: 

COU NT arithmetic expression cr 
command cr 

WHILE boolean-expression cr 
UNTIL boolean-expression cr 
END 

The arithmetic-expression after COUNT controls the (maximum) number of itera- 
tions to be performed. If a numeric constant is used (for example, COUNT 10), the 
ICE emulator interprets it in implicit decimal radix; in other words, any number 
entered after COUNT without an explicit radix is interpreted as a decimal number. 

If the entry after COUNT is an arithmetic-expression, it is evaluated to give the 
number of iterations. The COUNT expression is evaluated once, before any loop 
elements are encountered. It is not evaluated again on any interation. The COUNT 
expression uses the values of any references it contains as they stand at the time of 
evaluation. For example, consider the following command sequence: 

DEFINE .XX = 2 
COUNT .XX 

.XX = .XX + 1 

END 

This loop goes through two iterations, although .XX has value 4 when the loop 
terminates. 

The loop terminates when the number of iterations given by the COUNT expression 
has been performed or when an exit condition is tested and causes exit, whichever 
comes first. The following example illustrates this concept: 
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DEFINE. XX = 1 
COUNT 5 

.XX = .XX + 1 

WHILE .XX < 5 
END 

To show that the loop terminates on the WHILE condition before the COUNT 
expression is exhausted, we can "track" the loop in operation. Table 8-1 shows the 
track. 



Table 8-1 . Tracking a COUNT Command 



Iteration 


.XX 


.XX < 5 


1 


2 


TRUE 


2 


3 


TRUE 


3 


4 


TRUE 


4 


5 


FALSE 



The loop terminates during the fourth iteration, when .XX < 5 becomes FALSE. 

Conversely, the COUNT expression specifies the maximum number of iterations to 
be performed in case no exit clause produces an exit on any iteration. For example: 

TRACE = INSTRUCTION 
CS = SEG .START 
IP = OFF .START 
COUNT 10 

UNTIL CS:IP = . DELAY 

STEP 

PRINT -1 
END 

In this command, the COUNT expression specifies a maximum of ten STEPs, in 
case the first instruction at .DELAY is not reached during any iteration. 

With a REPEAT command or with a COUNT command that includes one or more 
clauses, there may be no direct way to tell how many iterations occurred before the 
loop terminated. For these cases, you can insert a loop counter as a loop element. 
For example, to obtain table 8-1 as a display (or LIST file output), you could use the 
following sequence: 

BASE = T 
DEFINE. ITER = 0 
DEFINE. XX = 1 
COUNT 10 

XX = .XX + 1 

. ITER = . ITER + 1 

.ITER 

.XX 

BOOL .XX < 5 
WHILE .XX < 5 
END 

The command BOOL .XX < 5 produces a display of TRUE or FALSE. 

The following example emulates to a breakpoint, displays status registers, then con- 
tinues emulating, breaking, and displaying status for a definite number of iterations: 

CS = SEG .START 
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IP = OFF .START 
COUNT 10 

GO TILL .PAUSE EXECUTED 

REGISTER 
END 



IF Command 

The IF command permits conditional execution in a command sequence. The IF 
command has the form: 

IF boolean-expression [THEN] cr 
[command cr] ... 



L [commander]... J 

[ELSE cr 1 
[commander] ...J 

END 

The command must have the IF clause; the ORIF and ELSE clauses are optional. 
The command can include as many ORIF clauses as desired. The IF and ORIF 
clauses each contain a single condition (boolean expression). Any clause can contain 
none, one, or more commands. A clause with no commands simply produces an exit 
when its condition is TRUE. 

The ICE emulator examines each boolean expression in turn, clause by clause, look- 
ing for the first TRUE condition. If a TRUE condition is found, the commands in 
that clause are executed and the IF command terminates. If none of the conditions is 
TRUE, the commands in the ELSE clause are executed and the IF command ter- 
minates. If the ELSE clause is omitted and no condition is TRUE, the IF command 
terminates with no commands executed. 

The END keyword is required to close off the IF command; it can be written as 
ENDIF to clarify nesting. 

Here is an example of the IF command: 

BASE = T 
IP = 1 
IF IP<1 

EVALUATE t 
ORIF IP < 2 

EVALUATE 2 
ORIF IP < 3 

EVALUATE 3 
ELSE 

EVALUATE 4 
END 

This example displays the result of EVALUATE 2 and then terminates. The first 
condition (IF IP < 1) is FALSE, so EVALUATE 1 is skipped. The second condition 
(ORIF IP < 2) is TRUE, so EVALUATE 2 is executed and the IF command ter- 
minates. The third condition (ORIF IP < 3) is not tested, even though it happens to 
be TRUE. 



ORIF boolean-expression [THENJcr 
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In practice, however, the IF command is useful when it is nested in a REPEAT or 
COUNT loop rather than appearing at the "top" level. The reason for this is that 
you want to test conditions that can change (due to other commands in the loop), 
whereas at the top level the TRUE or FALSE state of any condition is known, or can 
be determined with the BOOL command. Thus, the result from the previous exam- 
ple can be obtained with fewer steps: 

BOOL IP <1 (Displays FALSE) 
BOOL IP < 2 (Displays TRUE) 
EVALUATE 2 



Nesting Compound Commands 

The REPEAT, COUNT, and IF commands can be nested to provide a variety of 
control structures. 

Each nested compound command must have its own END keyword. When entering 
a nested command sequence, you may wish to use the keywords ENDR, ENDC, and 
ENDIF, to help you keep straight which command you intend to close off. The ICE 
emulator does not check nesting levels at entry, and if an END is omitted, the 
resulting error makes it necessary to enter the entire command again. 

Each nested REPEAT or COUNT command can contain its own exit clauses 
(WHILE or UNTIL). Each such exit clause can terminate the loop that contains it, 
but has no effect on any outer loops or commands. 

As an example of nesting, suppose you want to STEP through a program with trace 
display, but skip a repetitive timeout routine, .DELAY, that is called with an 8086 
short-call instruction several times during program execution. One way to achieve 
this effect is with the following command sequence: 

TRACE = INSTRUCTION 
CS = SEG .START 
IP = OFF .START 
REPEAT 

IF CS:IP = . DELAY 
IP = WORDSS:SP 
SP = SP + 2 

ENDIF 

STEP 

PRINT -1 
ENDR 

At each call to .DELAY in the program, the displacement of the return address for 
the call is pushed on the stack. The keyword SP refers to the stack pointer, and SS is 
the stack segment register; SS:SP is the address of the top of the stack where the 
return address is stored. The effects of the commands IP = WORD SS:SP and SP = 
SP + 2 are to load the return address back into IP and reset the stack pointer just as 
if the return instruction at the end of .DELAY had been executed. 

As another example of nesting, suppose the user code at statements #21 and #22 is 
incorrect or not written yet. The following sequence emulates to the point where 
substitute code is to be inserted, inserts the code (equivalent to IF MARK > 0 THEN 
PTR = PTR + 2 in PL/M), then continues emulating beginning with statement #23 
(the insertion is made any time emulation reaches statement #21): 

GO FROM .START TILL #21 EXECUTED 
REPEAT 



8-6 



ICE-86A 



ICE-86A Enhancements 



IF !MARK > 0 

!PTR = !PTR + 2 
ENDIF 

GO FROM #23 
ENDR 

An exit can be made only when a condition is tested, not when it occurs. To cause an 
exit, the test must be placed at the point in the loop where the condition occurs. For 
example, consider the following command sequence: 

CS = SEG .START 
IP = OFF .START 
REPEAT 

UNTIL IP = 1000H 

STEP 
ENDR 

In this command the condition IP = 1000H is tested after every STEP. If the 
sequence of STEPs reaches IP = 1000H as the next instruction, the loop will ter- 
minate. By contrast, consider this example: 

CS = SEG .START 
IP = OFF .START 
REPEAT 

UNTIL IP = 1000H 

COUNT 10 
STEP 

ENDC 
ENDR 

In the second example, the condition IP = 1000H is tested after every ten STEPs. 
The loop exits only if IP = 1O00H occurs at the end of some group of ten instruc- 
tions. If IP = 1000H occurs during one of the groups of ten STEPs, the loop does 
not terminate because that condition is changed by subsequent STEPs before the test 
can be made. 

If the command has more than one exit clause, each exit clause is tested when it is 
encountered. If the result at the moment of the test causes an exit, the loop ter- 
minates; otherwise, the loop proceeds to the next element. 

The loop exits only when the current test causes it, even though some other clause in 
the loop would cause an exit if it could be tested at that moment. Consider this 
(artificial) example: 

DEFINE. ZZ = 0 
CS = 0 
IP = 0 
REPEAT 

UNTIL IP >10H 

COUNT 5 

STEP 

ENDC 

PRINT -10 

WHILE .ZZ = 0 

.ZZ = .ZZ + 1 
ENDR 

Assume for this example that the code being emulated (with STEP) contains only 
two-byte instructions. Then, after the first time through the loop, IP = OAH (10T) 
and .ZZ = 1. On the second iteration, the test IP > 10H is FALSE when it is 
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encountered, so the STEP and PRINT commands are executed again. At this point, 
IP > 10H is TRUE but since it is not tested, no exit occurs. Instead, the condition 
.ZZ = 0 is tested, found to be false, and the loop exits. 

Macro Commands 

A macro is a block of commands. When a block of commands is defined as a macro, 
it is stored on diskette so that it can be executed more than once without having to 
enter the commands each time. The macro commands described in this chapter 
allow you to perform the following functions: 

• Define a macro, specifying the macro name, the command block, and any 
formal parameters (points where text can be filled in at the time of the macro 
call). 

• Invoke (call) a macro by name, giving actual parameters to fill in the blank 
fields in the macro definition, to begin the execution of the command block. 

• Display the text of any macro as it was defined. 

• Enable or disable the display of the text of macros when they are invoked. 

• Display the names of all macros currently defined. 

• Remove one or more macros. 

• Save one or more macro definitions on an ISIS-II file. 

In addition, the off-line facility (INCLUDE command) allows you to enter macro 
definitions from diskette files for use in the current test sequence. 

Defining and Invoking Macros 

Each macro is defined once in the test session. The syntax of the DEFINE MACRO 
(DEF MAC) command is as follows: 

DEF M AC macro-name cr 

[command cr]... 
EM 

Once it is defined, you can invoke (call) a macro as often as desired. The syntax of a 
macro call is: 

.macro-name [actual-parameter-list] 

The macro definition command causes the macro name and block of commands to 
be stored in a table of macro definitions in a temporary ISIS-II file named 
MAC.TMP. (This file is removed by the ICE EXIT command). 

warning! 



If you have a file on the ICE diskette named MAC.TMP, it will be lost 
when you enter the ICE-86A emulator. 

A macro-name must begin with an alphabet letter, or with one of the character "?" 
or "@". The characters after the first character can be alphabet letters, "?", "@", 
or numeric digits. The macro name must not duplicate a previously-defined macro 
name. 

A macro definition may not appear within any other command (REPEAT, 
COUNT, IF, or another macro definition). The command block in the macro defini- 
tion can include any command except another DEF MAC command or a REMOVE 
MACRO command. 
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The macro name in the macro invocation must be the name of a previously-defined 
macro. The form of actual-parameter-Hst is discussed later in this chapter. 

Here is a simple macro definition: 

DEF MAC GOER 

REPEAT 
GO FROM .START TILL BRO 

END 
EM 

To invoke this macro and cause its command block to begin executing, enter the 
macro name preceded by a colon (:). For example: 

:GOER 

A macro definition can include calls to other macros, but a macro cannot call itself 
recursively. Any macros called from within a macro must have been defined when 
the calling macro is invoked. Macro calls can be nested; i.e., one macro calls 
another, which calls another, and so on. The level of nesting is limited only by the 
memory space required to contain the macro expansions and "stack" the macro 
calls. 

When a macro is called as an outer level command, the following operations occur: 

• System default (SUFFIX) is saved in case a new default is set inside the macro. 

• The text of each actual parameter in the call is substituted for the corresponding 
formal parameter in the definition. 

• The expanded command block is executed if all commands are valid as 
expanded. 

• When the last command has finished, the former system default is restored. 

• The macro exits. Control returns to the console (asterisk prompt). 

The next several sections provide details on these operations, including the treatment 
of nested macro calls. 



Local and Global Defaults 



The system default can have a "local" setting within a macro; this default is as 
follows: 

Default Refers to: 

SUFFIX Default radix for console input. 

When a macro is called (or any compound command is executed), the current 
"global" setting of SUFFIX is saved so that it can be restored after the macro 
finishes executing its commands. The global default continues in effect within the 
macro unless and until a new (local) default is set with a SUFFIX command in the 
macro. Defaults other than SUFFIX are changed globally when they are set within a 
macro. 

When the macro finishes executing its command block, the previous SUFFIX 
default is restored. Thus, any SUFFIX default that is set within a macro has no 
effect after that macro has exited. 
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Here is an (artificial) example of a macro with a local default: 

DEFMACSETO 

SUFFIX = H 

BYTE 0 TO 10 = 0 
EM 

Without the local SUFFIX command, the range of addresses to be set would depend 
on the global SUFFIX in effect when the macro SETO is called. The global SUFFIX 
is restored after SETO exits. 



Formal and Actual Parameters 

A formal parameter marks a place in an ICE command where variable text can be 
"filled in" when the macro is called. A formal parameter can represent part of a 
token or a field of one or more tokens. A macro definition can contain up to ten for- 
mal parameters. A formal parameter has the form: 

%n 

where n is a decimal digit, 0 to 9. 

Formal parameters can appear in the macro definition in any order, and each one 
can appear any number of times. In most cases, the formal parameters form a com- 
plete numeric sequence with %0 as the lowest numbered parameter (even if % is not 
the first parameter to appear). However, one or more parameters can be omitted 
from the sequence; the effect of omitting a formal parameter from the sequence is to 
ignore the actual parameter in the call that corresponds to the omitted formal 
parameter. 

The macro call can contain as many actual parameters as desired. Enter multiple 
parameters as a list, with entries separated by commas. The first actual parameter in 
the list is substituted at all points that °7oO appears in the macro definition; the 
second parameter substitutes for %1, and so on. 

An actual parameter can be "null", causing the ICE emulator to substitute a null 
for the formal parameter to which it corresponds. You can pass a null parameter to 
a macro in two ways: 

• Enter no actual parameter between consecutive commas. 

• Omit one or more parameters from the end of the list. 

If too few actual parameters are entered, the ICE emulator supplies nulls for the 
extra formal parameters. If too many actual parameters are entered, the extra actual 
parameters are ignored. 

If any actual parameter contains a carriage return, a comma, or a single quote mark, 
the entire parameter must be enclosed in single quotes to identify it as a single actual 
parameter. In other words, parameters with these characters must be entered as 
strings. A single quote within a string is entered as ('*). 

Here are some examples to demonstrate the use of formal and actual parameters: 
Example 1: 

DEF M AC MEM 

%0INTEGER%1 
EM 
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In the call to this macro, parameter %0 can become "S" or null. Parameter % 1 can 
be any valid address or partition. Examples of calls to this macro: 



Example 2: 

DEF MAC RPT 
REPEAT 

%0 
%1 
%2 
%3 
%4 
%5 
%6 
%7 
%8 
%9 
END 
EM 

Macro RPT can accept up to ten commands to be repeated. For example: 

:RPT GO TILL BRO, PRINT -1 , REGISTERS, GO TILL BR1 , PRINT -10 

If fewer than ten commands are given, as in the example above, the extra formal 
parameters are ignored (treated as nulls). This shows how to do REPEAT on one 
line with no end required. 

Example 3: 

DEF MAC BRS 
BR%0 = %1 
EM 

Use of macro BRS may require parameters entered as strings, since some ways to set 
breakpoints involve embedded commas. For example: 

:BRS 0, tOOOH- EXECUTED 
This parameter is valid, but this one: 

BRS 0, FFH, .START LEN 100H 
results in the expansion : 

BRO = FFH 

To obtain the correct expansion, make the parameter a string: 

:BRS0, 'FFH, .START LEN 10GH' 

« 

This results in the expansion: 
BRO = FFH, .START LEN 100H 



Macro call 



Expansion 



:MEMS,1000H 
:MEM,1000HTO100FH 



SINTEGER 1000H 
INTEGER 1000H TO 100FH 
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Details on Macro Expansion 

The syntax and semantics of commands in a macro block are ignored at the point of 
definition; they are not determined until invocation, and may be different on each 
invocation through the use of formal parameters. 

When a macro is called, its definition is expanded by adding the text of any actual 
parameters in the call at the points indicated by formal parameters in the definition. 
If the expanded macro contains any calls to other macros, the text of any such 
macros is also expanded, forming in effect one overall block of commands. Expan- 
sion continues until the last EM is reached. If the expansion results in a set of 
complete, valid commands, the commands are executed. An error results if any 
command is incomplete or invalid after expansion. 

A macro invoked in a REPEAT, COUNT, or IF command is expanded immediately 
after the macro call command is entered. Thus, a macro called in a REPEAT or 
COUNT command is expanded only once, and a macro called in an IF command is 
expanded whether the condition in the IF or ORIF clause that contains the macro 
call is TRUE or FALSE. 



The ENABLE/DISABLE EXPANSION Command 

The ENABLE/DISABLE EXPANSION command controls the display of macros 
after they have been called. If EXPANSION is enabled, the fully-expanded macro is 
displayed when it is invoked. If EXPANSION is disabled, then no display occurs. A 
macro that is not displayed when it is invoked is termed a "silent" macro. 

EXPANSION is initally disabled. The state of EXPANSION does not affect the 
execution of macros, i.e., execution occurs if there are no syntax errors, regardless 
of whether EXPANSION is enabled or disabled. The syntax of the command is: 

DISABLE EXPANSI0N 
Examples: 

'ENABLE EXPANSION 
'DISABLE EXPANSION 



Macro Table Commands 

The macro table contains the name and text of all macros currently defined. The text 
is stored as it is defined, and does not contain any expansions. 

The DEFINE MACRO (DEF MAC) command adds the macro defined to the end of 
the table. The syntax of this command appears earlier in this chapter. The DEF 
MAC command may not appear with any other command. 

The REMOVE MACRO (REM MAC) command removes one or more macro 
definitions from the table. The syntax of this command is: 

REM MAC [macro-namelmacro-name]...] 

If the list of macro-names is omitted, all macros are removed. The REM MAC com- 
mand may not appear within any other command. 
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The display macro command displays the name and definition of one or more 
macros from the macro table. The syntax is: 

MAC [macro-name ] ,macro-name ]...] 

If the list of macro-names is omitted the definitions of all macros in the table are 
displayed. 

The macro directory command displays the names of all macros in the table. The 
syntax is: 

DIR MAC 

Here are some examples of these commands (assume that the table contains all the 
macro examples defined thus far in this chapter): 

Example 1 : 



*DIR MAC 

GOER 

SETO 

MEM 

RPT 

BRS 



(command) 
(display) 



Example 2: 



*MAC GOER 
DEF MAC GOER 
REPEAT 

GO FROM .START TILL BRO 

END 

EM 

Example 3: 

REM MAC BRS 

Example 4: 

*DIR MAC 

GOER 

SETO 

MEM 

RPT 



(command) 
(display) 



(command) 



(command) 



Example 5: 



*DEF MAC NULL 
*EM 



(command) 



Example 6: 



*DIR MAC 

GOER 

SETO 

MEM 

RPT 

NULL 



(command) 
(display) 
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Saving Macros 

The PUT MACRO (PUT MAC) command causes one or more macro definitions to 
be copied from table to an ISIS-II diskette file. The syntax is: 



PUT [:drive:] filename MACRO [macro-name[,macro-name]...] 



If any macro names are entered, those macro definitions are saved. If no list of 
macro names is given, all macros in the table are saved. The definitions in the macro 
table are not affected by the operation. 

The file containing the saved macro can later be edited or brought into another ses- 
sion with the INCLUDE command, discussed later in this chapter. 

If the named file does not exist, it is created by the PUT command. If the file does 
exist on the diskette, the file is opened for input and the macros in the list are written 
on the file, destroying the previous contents of that file. 



Further Examples 

Here are a few more examples of macros. These macros simulate stack operations, 
calls, and returns in the ICE-86A emulator. 

A stack is an area of memory, indexed (addressed) by a register called the stack 
pointer (SP) and stack segment register (SS). The stack is used to save status 
information required for an orderly return from a procedure cal[. 

In the ICE-86A emulator, the stack is in mapped memory. The bottom (first 
available location) is the highest address in the stack area; the stack expands as 
needed into successively lower addresses. The stack pointer points to the address 
(word) at the top of the stack; this address contains the last item pushed on the 
stack. As each new word is pushed on the stack, SP is decremented to point to the 
new top address. Most of the values that need to be saved on the stack are 16-bit 
values. The high byte is stored in the address pointed to by (SS:SP - 1), and the low 
byte is stored in the next lower address (equivalent to SS:SP - 2). 

The MCS-86 assembly language PUSH rp instruction sets SP to the next available 
word, then stores the content of the given register pair rp in adjacent addresses at 
that position. We can simulate this action with a macro, as follows: 

DEF MAC PUSH 86' 

SP = SP - 2T ;decrement SP 

WORD SS:SP =%0 ;low byte in low address, high byte in 

EM high address. 

The formal parameter %0 lets us use PUSH86 to save any register pair or other 
16-bit value; for example: 



PUSH86 IP ;save instruction register 

PUSH86 RAX ;save RAX 

PUSH86RBX ;saveRBX 

PUSH86 RCX ;save RCX 



The complementary MCS-86 POP rp instruction copies the contents of the two top 
bytes back into the given register pair, then increments SP to the new top of the 
stack. A macro for this function is: 



DEF MAC POP86 
%0 = WORDSS:SP 
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SP = SP + 2T 
EM 

Here are some calls to POP86, corresponding to the PUSH86 calls given earlier: 

:POP86 RCX 
:POP86 RBX 
:POP86 RAX 
:POP86IP 

Here are some macros that use PUSH86 and POP86. 

1 . Macro to ''call" (short-call) a procedure: 

DEF MAC CALL86 
:PUSH86 IP 
GO FROM CS:%0 

EM 

This macro can be invoked with or without a halt condition: 

:CALL86.PROCor 
:CALL86.PROCTILLBR0 

2. Macro to "call" (long-call) a procedure: 

DEF MAC LCALL86 
:PUSH86 CS 
:PUSH86IP 
GO FROM %0 

EM 

To invoke this macro: 

:LCALL86.PROCor 
:LCALL86.PROCTILLBR1 

3. Macro to "return" (short-return) from a procedure: 

DEF MAC RET86 
:POP86IP 
GO %0 

EM 

To invoke this macro: 

:RET86or 
:RET86 TILL BRO 

4. Macro to "return" (long-return) from a procedure: 

DEF MAC LRET86 
:POP86IP 
:POP86 CS 
GO%0 

EM 

To invoke this macro: 

:LRET86 or 
:LRET86 TILL BRO 

5. Macro to single-step through user code, skipping over a specified procedure 
whenever that procedure is called from the user program, and printing the 
instruction j ust executed each time . 

DEF MACRO SKIP 
REPEAT 
IFCS:IP = %0 

:POP86 IP (short-called procedure) 

ENDIF 
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STEP 
PRINT -1 
ENDR 
EM 

DEF MACRO LSKIP (long-called procedure) 
REPEAT 
IFCS:IP = %0 
:POP86IP 
.POP86CS 
ENDIF 
STEP 
PRINT -1 
ENDR 
EM 

Suppose the user program contains a respective timer routine named DELAY that is 
called from several places in the program. The following macro invocation causes 
the ICE emulator to step through the program without emulating the timer routine: 

:SKIP .DELAY 



Off-line Facilities 

In addition to the compound and macro commands described above, the INCLUDE 
command allows you to access macro definitions stored in diskette files and to cause 
them to be executed from these files rather than the console. 



INCLUDE Command 

The INCLUDE command causes input to be taken from the file specified until the 
end-of-file, at which point input continues to be taken from the previous source, 
normally the console. 

The syntax of the INCLUDE command is: 

INCLUDE I [.drive:] filename 1 
I .device: ) 

Nesting of INCLUDE command is permitted. For example: 

IP = .START 
REPEAT 

UNTIL IP = . HALT 

INCLUDE PROGA.INC 
INCLUDE PROGB.INC 

ENDR 

The console (:CI:) may be given as the filename, in which cases control-Z must be 
used as end-of-file. The files are echoed on the console. 

As macros can be complex and editing may be required on the macro definition, the 
INCLUDE command allows you to access offline macro definitions and to create 
online macros, which combine to form the macro suite for a particular debugging 
session. However, command lines may appear in the INCLUDE file, not just macro 
definitions. 
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Write Command 

The WRITE command writes one or more list elements to the console and to the list 
file at run time. 

The syntax of the WRITE command is: 

WRITE fist-element [Jist-element] 
where 

list-element = string : : expr : : BOOL expr 

For example: 

WRITE $CTIME, 'SECONDS SINCE LIGHT CHANGE' 

would output a message showing the time in seconds (in CARS2) (see Chapter 3) 
since the traffic light changed. 

This command writes the list-element (s) to the console all on the same line except 
when the nest-element will not fit into the remaining character space on the current 
line. In this event, a carriage return and a line feed will be inserted. If the list-element 
is a string, it will be displayed. If the list-element is an expr, the value of the expres- 
sion is displayed in the current base. A single character string is displayed as a string. 
When a single character string is used in an expression, its corresponding hexa- 
decimal value is used in evaluating the expression, and the value of the expression is 
displayed. 

If the list-element is BOOL expr, the ICE emulator displays the boolean value 
TRUE when the least-significant bit (LSB) of the result is 1, FALSE when the LSB is 
0; no spaces are provided either before or after the boolean value. 



The WRITE command can also be used to display values which are typed as REAL, 
DREAL, or TREAL. 

For example: 

*REA 2010 = 1.23E-5 



* WRITE REA 2010 
+ 1.23000000E-5 
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ABSOLUTE ABS 

ACKNOWLEDGE ACK 

ADDR ADD 

AFL AFL 

ALL ALL 

AND AND 

ASCII ASC 

ASM ASM 

BASE BAS 

BHE BHE 

BOOL BOO 

BP BP 

BR BR 

BRO BRO 

BR1 BR1 

BUFFERSIZE BUF 

BUS .BUS 

BYTE BYT 

CAUSE CAU 

CFL CFL 

CLOCK CLO 

CONDITIONALLY .... CON 

CONTINUOUS CON 

COUNT COU,C 

CS CS 

DASM DASM 

DEFINE DEF 

DFL DFL 

DI DI 

DIR DIR 

DISABLE DIS 

DISK DIS 

DMUX DMU 

DOMAIN DOM 

DOWN DOW 

DREAL DRE 

DS DS 

ELSE ELS 

EM EM 

EMULATIONTIME. . . . EMU 

EMULATOR EMU 

ENABLE ENA 

END END 

ERROR ERR 

ES ES 

EVALUATE EVA 

EXECUTED EXE,E 

EXIT EXI 

EXPANSION EXP " 

EXTADDR EXT 

EXTERNAL EXT 

FETCHED FET 

FLAG FLA 

FOREVER FOR 

FRAME . . . . . FRA 

FROM FRO,F 

GO G 

GR G 

GUARDED GUA 

H .H 

HALT..... HAL,H 

HARDWARE HAR 



HOLD HOL 

HTIMER HT1 

ICE ICE 

IF IF 

IFL IFL 

INCLUDE INC 

INFINITE INF 

INPUT INP,1 

INSTRUCTION INS 

INTEGER INT 

INTELLEC INT 

INTERNAL INT 

IP IP 

IR IR 

LENGTH LEN 

LINE LIN 

LIST LIS 

LOAD LOA 

LOWER LOW 

MACRO MAC 

MAP MAP 

MARK MAR 

MASK MAS 

MATCH MAT 

MN.. MN 

MOD. MOD 

MODULE MOD 

MOVE MOV,M 

NESTING NES 

NEWEST NEW,N 

NMI NMI 

NOCODE NOC 

NOERROR NOE 

NOLINE NOL 

NOSYMBOL NOS 

NOT NOT 

NOVERIFY NOV 

NOW NOW 

OBJECT OBJ 

OF OF 

OFF OFF 

OFFSET OFF 

OFFTRACE OFF 

OFL OFL 

OLDEST ....OLD,0 

ON ON 

ONTRACE ONT 

OPCODE OPC 

O R 

ORIF ORI 

OUTPUT OUT,0 

PFL PFL 

PIN PIN 

PIP PIP 

POINTER POI 

PORT POR 

PRINT PRI,P 

PUT PUT 

Q Q 

Q DEPTH QDE 

QSTS QST 

RAH RAH 



RAL RAL 

RAX RAX 

RBH RBH 

RBL RBL 

RBX RBX 

RCH RCH 

RCL RCL 

RCX RCX 

RDH RDH 

RDL RDL 

RDX RDX 

RDY RDY 

READ REA,R 

REAL REA 

REGISTER REG,R 

REMOVE REM 

REPEAT REP 

RESET RES 

RF RF 

RQGT RQGT 

RST RST 

RWTIMEOUT RWT 

SAVE SAV 

SEGMENT SEG 

SELECTING SEL 

SFL SFL 

SI SI 

SINTEGER SIN 

SP SP 

SS SS 

STACK STA 

STEP... STE,S 

STS STS 

SUFFIX SUF 

SYMBOL SYM 

SYMBOLICALLY SYM 

T T 

TEST TES 

TFL TFL 

THEN THE 

TILL TIL,T 

TIMER TIM 

TO TO 

TRACE TRA 

TREAL TRE 

TYPE TYP 

UNTIL UNT 

UP UP 

UPPER UPP 

USE USE 

USER USE 

VALUE VAL 

WHILE WHI 

WORD WOR 

WPORT WPO 

WRITE WRI 

WRITTEN WRI,W 

XOR XOR 

Y Y 

ZFL ZFL 

86. 86 

87 . . 87 
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The following is a list of error messages. 

ERR 10.RSLTS BLK INACCESSIBLE 

A bus timeout was detected on an attempt to write the results block. 

ERR 1V.XMIT BLK INACCESSIBLE 

A bus timeout was detected on an attempt to read the transmit block. 

ERR 16:DVC CD FORMAT ERROR 

The format byte of device code table was determined to be non-zero. 

ERR 17:DVC NOT IN DVC CD TABLE 

A device code corresponding to this ICE was not found in the device code table. 

ERR 21 -.COMMAND NOT ALLOWED NOW 

The command code in the parameter block cannot be processed at this time. 

NOTE 

This error can occur after pressing the ESC key if the buffer box is 
not properly grounded to the user system via the buffer box 
grounding cable. 

ERR 30:PGM MEMORY FAILURE 

Data read back from program memory did not agree with data written. 

ERR 31 :DATA MEMORY FAILURE 

Data read back from data memory did not agree with data written. 

ERR 32:BREAKPOINT MEM FAILURE 

Data read back from breakpoint memory did not agree with data written. 

ERR 33:MEMORY MAP FAILURE 

Data read back from memory map did not agree with data written. 

ERR 34:CABLE FAILURE 

Cable diagnostic program detected a failure in the cable. 

ERR 35:CONTROL CIRCUIT FAILURE 

Control diagnostic program detected a failure in the control circuitry (see 
note 1). 

ERR 36:PAGE FAULT 

Not an error. Access was made to disk mapped memory and firmware doesn't 
have page containing that location. 

ERR 37:INTELLEC MEMORY FAILURE 

Intellec memory does not verify when written to: it may be missing, non- 
writable, or bad memory. 

ERR 40:NO USER CLOCK 

In external clock mode, the CPU clock is not present. 

ERR41:NOUSERVCC 

In external clock mode, the user Vcc is not present. 
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ERR 42:GUARDED ACCESS 

Access was made to a guarded memory or I/O location. 

ERR 43:PROCESSOR NOT RUNNING 

In external clock mode, the user ready signal is not present. 

ERR 48:READY TIMEOUT 

In external clock mode with timeout on ready selected, a command timeout 
occurred. 

ERR 49:HOLD SEQUENCE ERROR 

A hold request was initiated and removed before hold ACK became active (see 
note 2). 

ERR 4A:HOLD TIMEOUT 

Cannot exit emulation or examine user memory because hold is inactive too 
long in the user system (see note 1). 

ERR 4B:RESET TIMEOUT 

Cannot exit emulation because reset is inactive (see note 1). 

ERR 80.SYNTAX ERROR 

The token flagged is not one that is allowed in the current context. 

ERR 81 ".INVALID TOKEN 

The token flagged does not follow the rules for a well-formed token. 

ERR 82:NO SUCH LINE NUMBER 

The specified line number does not exist in the current module. 

ERR 83:INAPPROPRIATE NUMBER 

The value is not appropriate in the current context. 

ERR 84:PARTITION BOUNDS ERROR 

The partition values entered in a command are not correct. Either the left part 
of the partition is greater than the right part, or the values of the partition 
extremes are out of range in the current context. 

ERR 85:ITEM ALREADY EXISTS 

The item entered in a define command is currently defined in the symbol table. 

ERR 86:ITEM DOES NOT EXIST 

The item printed on the preceding line does not reside in the symbol table. 

ERR 87:DUPLICATE CHANNEL 

The channel specified appears more than once in a channel list. 

ERR 88:MACRO PARAMETER ERROR 

Too many macro parameters or macro parameter too long. 

ERR 89:MISSING CR-LF IN FILE 

Include file doesn't end in carriage-return line-feed. 

ERR 8A:FORMAT ALREADY EXISTS 

The format specified in a define command is already defined. 

ERR 8B:FORMAT DOES NOT EXIST 

The format specified has not been defined. 
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ERR 8C:COM PARE MODE NOT ACTIVE 

Find command was issued while compare trace mode was not active. 

ERR 8D:EMPTY TRACE BUFFER 

Trace buffer is uninitialized. 

ERR 8E:INVALID TRACE REFERENCE 

Trace reference made while trace buffer uninitialized. 

ERR 8F:N0N-NULL STRING NEEDED 

A null string was used where a non-null string is required. 

ERR 90-.MEMORY OVERFLOW 

Memory requirements of all dynamic tables exceed the amount of memory 
available. 

ERR 91 .STACK OVERFLOW 

The capacity of a statically allocated stack internal to the diagnostic program 
has been exceeded. 

ERR 92-.COMMAND TOO LONG 

The capacity of the statically allocated intermediate code buffer has been 
exceeded. 

ERR 93-.MODULE DOES NOT EXIST 

Module specif ied does not exist in symbol table. 

ERR 94:NON-CH ANGEABLE ITEM 

An attempt was made to change an item that may not be changed. 

ERR 95:INVALID OBJECT FILE 

File specified in a load command is not a valid object file. 

ERR 96-.INVALID WITHIN ACTIVATE 

The command is not valid within an activate block. 

ERR 97:EXCESSIVE DATA 

The amount of data attempted to be inserted into a partition exceeded the size 
of the partition. 

ERR 98:MORE THAN 16 CHANNELS 

More than 16 channels specified in a channel list. 

ERR 99: EXCESSIVE ITERATED DATA 

The amount of data to be repeated throughout a range of memory exceeds the 
size of the buffer allocated to hold such data. 

ERR 9A:T0O MANY GROUPS 

Number of groups defined by user may not exceed 43. 

ERR 9B-.T00 MANY CHANNELS 

Number of channels defined by user may not exceed 128. 

ERR 9C: U NSU ITABLE EXECUTE FILE 

The file referenced in an execute command either contains code that is out-of- 
bounds for the execute command, or it is a main module. 

ERR 9D:LINE TOO LONG 

Command line was longer than 122 characters. 
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ERR 9E: HOST-ONLY COMMAND 

The command issued is not allowed in an activation list. 

ERR 9F:PROCESS ALREADY ACTIVE 

Attempt made to activate a process that was already active. 

ERR A0:TOO MANY PARTITIONS 

Number of partitions or single breakpoints in a breakpoint register exceed max- 
imum permissible value. 

ERR A1 :PARTITION CROSSES PAGE 

Breakpoint partition was not contained on a single page. 

ERR A2:ILLEGAL CLOCK VALUE 

Value specified for clock is not a permissible value. 

ERR A3:PROCESS ALREADY DORMANT 

Attempt made to suspend or terminate a dormant process. 

ERR A4:MACRO FILE FULL 

Macro file contains more than 64K characters. 

ERR A7:IN APPROPRIATE TYPE 

The type and value entered are inconsistent. Note: Error A7 displayed the string 
"POINTER VALUE REQUIRED" in previous 8086 emulators. 

ERR A8:INTEGER VALUE REQUIRED 

A non-integer (i.e., pointer with non-zero base) value was used in a context that 
must use an integer. 

ERR A9:CANNOT REDECLARE MAP 

An attempt was made to declare the disk map after it was already declared— the 
map must be reset in order to redeclare. 

ERR AA:MEMORY UNAVAILABLE 

The Intellec or disk memory explicitly given in a set-map command was never 
declared, or no explicit memory was given and there is no more Intellec, disk, or 
ICE memory available for ICE-86A to assign. 

ERR AC:TAKES TOO MANY BRS 

A match condition was given that requires more breakpoint registers than is 
allowed in the current context; either it required more than one register in a set 
breakpoint command, or required more than two registers in a till clause. 

ERR AD:DIFFERING BASES 

Two pointers with different bases were used in a context where they must have 
the same base, e.g., the lower and upper bounds of a partition. 

ERR AE.INVALID "AND" IN GO-REG 

The GO-register is "TILL BRO AND BR1" during a GO command, but either 
(1) BRO or BR1 contains an execution-type match condition, or (2) BRO con- 
tains a data-time condition and BR1 contains an address-time condition. 

ERR B2:INVALID BASE 

The base used in the display breakpoint/tracepoint command is out of range for 
part or all of the addresses in the register (e.g., "BRO BASE 0" when BRO con- 
tains address 10000H). 

ERR B3:SYMBOL HAS NO TYPE 

A symbol being used in a typed memory reference (e.g., "!X") has no type. 
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ERR B5:BL0CK IS EMPTY 

ERR BB.INVALID REAL NUMBER 

The syntax of the real number is incorrect. 

ERR BC.REAL NUMBER TOO LONG 

The real number had greater than 30 digits of mantissa without an exponent or 
greater than 25 digits of mantissa with an exponent. 

ERR BD:EXPONENT TOO LARGE 

The exponent generated for a real number was greater than the 4 digits allowed. 

ERR BE:MIXED REAL TYPES 

REAL, DREAL, and TREAL values were mixed illegally, e.g., REA 1000 = 
TRE 2000. 

ERR BF'.REAL NUMBER OVERFLOW 

A real number that was not in the allowed range for reals was generated by the 
system or entered by the operator. The memory is not modified if this error 
occurs. 

WARN CO:UNSATISFIED EXTERNALS 

The program just loaded contains externals which were not satisfied at link 
time. The program was loaded correctly except for references to the unsatisfied 
externals. 

WARN C1 :MAPPING OVER SYSTEM 

The user has modified the map so that part of his address space includes either 
the ISIS system or the GID software package. 

WARN C2:HARDWARE MISSING 

An attempt was made to initialize the device whose generic device code number 
is printed on the previous line but no device responded. A generic device code is 
the first of four consecutive device codes reserved for a specific type of device. 

WARN C3: MULTIPLE HARDWARE 

An attempt was made to initialize the device whose device code number is 
printed on the previous line but more than one device responded. 

WARN C4:INVALID "AND" IN GR 

The GO-register is as described for ERR AE after GR, BR0 or BR1 was 
changed. 

WARN C5:INTELLEC MEM FAILURE 

The Intellec memory whose physical segment number is on previous line does 
not verify when written to: it may be missing, non-writable, or bad memory. 

WARN C6:HARDWARE REINITIALIZED 

The hardware has been reinitialized, setting trace buffer to 0, i.e., no data is in 
the trace buffer. 

WARN C7:CLEARING TFL TO 0 

WARN C8:REINITIALIZING— FAULT 

The hardware is being reinitialized 

ERR E7:ILLEGAL FILENAME [4] 
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ERR E8:ILLEGAL DEVICE [5] 

Illegal or unrecognized device in filename. 

ERR E9.FILE OPEN FOR INPUT [6] 

Attempt to write to a file open for input. 

ERR EB:FILE OPEN FOR OUTPUT [8] 

ERR EC:DIRECTORY FULL [9] 

ERR EE:FILE ALREADY IN USE [11] 

ERR EF:FILE ALREADY OPEN [12] 

Attempted to open a file that was already open. 

ERR F0:NO SUCH FILE [13] 

The file specified does not exist. 

ERR FV.WRITE-PROTECTED FILE [14] 

Attempt to open a write-protected file for the purposes of writing data into it. 

ERR F3:CHECKSUM ERROR [16] 

A checksum error in a hex object file was encountered during loading. 

ERR F6:DISK FILE REQUIRED [19] 

Attempt to use a non-diskette file where a diskette file was required. 

ERR F9:ILLEGAL ACCESS [22] 

Attempt to open a read-only file for the purposes of storing data (i.e., specify- 
ing :CI: as the list device) or a write-only file as a source of data (i.e., :LP: in a 
load command). 

ERR FA:NO FILENAME [23] 

No filename specified for a diskette file (i.e., no filename following :F1 :). 

ERR FD:"DONE" TIMED OUT 

The device whose device code number is printed on the preceding line was 
invoked but failed to return done within 5 seconds. 

ERR FE:"ACKNOWLEDGE" TIMED OUT 

ICE-86A software attempted to pass information to ICE-86A hardware, but the 
hardware did not respond by setting the acknowledge flag of the parameter 
block within 5 milliseconds. Specifically, ICE-86A firmware did not 
acknowledge receipt of the command in time. 

ERR FF:NULL FILE EXTENSION [28] 

A file was specified so as to contain an extension but no extension was specified. 

Note 1 . If error 35, 4A, or 4B occurs during emulation, hardware will be reset as if a 
RESET HARDWARE was executed. The emulation will not be recoverable 
as all registers will be set to the values they contained at the beginning of 
emulation. Warning message C6 may be issued. 

Note 2. Error 49 will cause emulation to exit properly and warning message C6 will 
be issued. 

Note 3. Bracketed number following error message refers to the ISIS error 
identified by this number. 
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Note 4. Error messages other than those documented in this list should not occur. If 
you encounter such an error, please report it to Intel Corporation, 3065 
Bowers Avenue, Santa Clara, CA 95051 MCSD, Customer Marketing, or 
your local Field Application Engineer. 
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debug session = [top-level command cr] . . . 

top-level command = define macro command : : remove macro command : : command 
command = compound command : : s/mp/e command 

compound command = if command : : repea/ command : : cotm/ command : : wr/te command 
simple command = display break /trace command : : se/ break /trace command : : 



go command : : step command : : go-register command : : 

enable/disable trace command : : /race command : : o/oes/ command : : 

newest command : : pr/7?/ command : : move command : : c/oc/c command : : 

command signal timeout command : : enable/disable ready command : : 

display command : : change command : : ofe/me command : : 

display symbols command : : display lines command : : 

display modules command : : change symbol command : : 

remove symbols command : : 5e/ domain command : : 

rese/ domain command : : display map command : : 

declare map command : : sef map command : : resef map command : : 

/oao/ command '.'.save command : : su/ftx command : : ^?ase command : : 

evaluate command : : //'s/ command : : ex/'/ command : : 

rese/ hardware command : : display macro command : : 

ptv/ macro command : : dir command : : include command 

enable/disable symbolically command :: enable/disable expansion command :: 

disassembly command : : ofefme c/asm command : : set /display rqgt command : : display 

bus command : : display cause command 



expr = boolean term [or-op boolean term] ... 
or-op =0R ::XOR 

boolean term = boolean factor [AND boolean factor] ... 

boolean factor = [NOT] boolean primary 

boolean primary = ar/Y/i expr [rel-op arith expr] 

rel-op =<::>::<= :: >=::<>:: = 

ar/Y/j expr s memory reference : : por/ name : : address 

address = arith term [MASK arith term] ... 

ar/Y/i /erm s /errn [plus-op term] ... 

plus-op = + : : - 

term = /actor [mult-op factor] ... 

mult-op = *::/:: MOD. 

factor = [p/t/s-op] [segment-op] primary 

segment-op = primary : :: OFFSET :: SEGMENT 

primary = (expr) : : numeric constant : : source statement number : : s/r//7g : : 
symbolic reference : : keyword reference 

symbolic reference = [module name] symbol [symbol] ... 
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module name = ..identifier 
symbol 3 .identifier 

source statement number s [module name ] # primary -10 
primary-10 = primary 

key word reference = register name : : #ag name : : p/V? /?a/77e : : fypetf memory reference 
partition = address [TO address] '.'.address LENGTH address 

Keyword Operators 

register name = RAL :: RAH ■:: RBL :: RBH :: RCL :: RCH :: ROL :: ROH :: RAX ::: RBX :: RCX :.: 
RDX : : SP : : BP : : SI : : PI : : S3 : : DS : : ES : : IP : : CAUSE : : OPCODE : : RF : : PIP : 
TIMER :: HTIMER :: BUFFERSIZE :: UPPER :: LOWER 

flag name s AFL : : CFL : : DFL : : IFL : : OFL : : PFL : : SFL : : TFL : : ZFL 

pin name = RDY : : NMI : : TEST : : HOLD : : RST : : MN : : IR 

port name = PORT address : : W 'PORT address 

memory reference = memory-designation address 

memory-designation = BYTE :: WORD :: SINTEGER :: INTEGER :: POINTER :: REAL :: DREAL 
TREAL 

typed memory reference = [!! identifier] ! identifier [[identifier] ... 

Emulation Controls and Commands 

display break /trace command = break /trace reg [display break /trace mode] 

set break /trace command = break /trace reg = match-cond 

break/ trace reg = break reg '. : trace reg 

break reg = BR :: BRO :: BR1 

trace reg = ONTRACE :: OFFTRACE 

display break/trace mode = ABSOLUTE : : BASE [expr] 

match-cond = execution match code : : non-execution match cond 

execution match cond = match value EXECUTED 

non-execution match cond = address match range [match status list] [data match range] 

[segment register usage ] : ; match status list [data match range ] 
[segment register usage ] : : data match range 
[segment register usage] : : segment register usage 

match value = address : : masked constant 

address match range = match range 

data match range = VALUE match range 

match range = match value : : match partition [, match partition] . . . : : address up/down 
match partition = partition :: OBJECT memory reference :: OBJECT typed memory reference 
up/down s UP:: DOWN 

match status list = match status [, match status] ... 

match status = READ :: WRITTEN :: INPUT :: OUTPUT :: FETCHED :: HALT :: ACKNOWLEDGE 
segment register usage = USING segment register name 
segment register name = SS : : CS : : DS : : ES 
go command = GO [FROM address] [go-register] 
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step command = STEP [FROM address] 
go-register command = G R [= go-register] 
go-register s FOREVER : : TILL break 

break = break reg [and /or break reg] :: match-cond [and /or match-cond] 
and/or = AND:: OR 

enable/disable trace command = ENABLE TRACE [CONDITIONALLY [NOW m/Y/a/ frace ] ] : : 

DISABLE TRACE 

m/'f/'a/ frace = ON ::OFF 

/race command = TRACE [= /race moc/e] 

trace mode = FRAME :: INSTRUCTION 

oldest command = OLDEST 

newest command = NEWEST 

print command = PRINT [ [plus-op] primary-10] : : PRINT ALL 
move command = MOVE [ [plus-op] primary-10] 
clock command = CLOCK [= clock setting] 
clock setting = INTERNAL :: EXTERNAL 

command signal timeout command = RWTIMEOUT [= new signal] 
new signal = INFINITE :: expr-10 [ERROR] :: expr-10 NOERROR 
expr-10 = expr 

enable/disable ready command = ENABLE RDY :: DISABLE RDY 

Interrogation and Utility Commands 

display command = reference [, reference] ... :: mem or//o partition : : ASM partition : : 
REGISTER : : FLAG : : PIN : : STACK expr : : BOOL expr 

mem or i/o = memory-designaltion : : PORT : : WPORT 

change command = reference = expr:: mem or i/o partition = change exp [, change exp] ... 

change exp s mem or //o partition : : expr : : string 

define command = DEFINE [module name] symbol = expr [OF fype] 

display symbols command = SYMBOL : : symbolic reference 

display lines command = LINE : : source statement number 

display modules command = MODULE 

change symbol command = symbolic reference = expr [OF fype] 

remove symbols command = REMOVE symbolic reference [, symbolic reference] ... : 

REMOVE SYMBOL:: 

REMOVE MODULE module name [, module name] ... 

type = memory desig 

set domain command = DOMAIN module name 
reset domain command = RESET DOMAIN 
caase command = CAUSE 

enable/disable symbolically command = i ENABLE | SYMBOLICALLY 

I DISABLE) 

display map command = MAP [partition] 
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declare map command = MAP DISK = file name : : MAP INTELLEC = partition [, partition ] ... 
set map command = MAP partition = new memory map 
reset map command = RESET MAP 

new memory map = GUARDED :: USER [NOVERIFY] :: ICE [address] [NOVERIFY] :: 
INTELLEC [address] [NOVERIFY] :: DISK [address] [NOVERIFY] 

load command = LOM) path name f~ NOCODE ~j 

NOSYMBOL . .. [SELECTING module partition [,module partition]...] 
L NOLINE J 

module partition = J module name \ 
\ module name TO module name i 

save command = SAVE path name JTsave code | 

NOSYMBOL 

Lnoline J 
save code = NOCODE '.'.partition [, partition] ... 
suffix command = SUFFIX [= suffix] 
base command = BASE [= base] 
suffix h=Y::0::Q::T::H 
base = saWx : : ASCII 

evaluate command = EVALUATE expr [SYMBOLICALLY] 

disassembly command = DEFINE DASM (86 | 

87 

i EMULATOR) 

list command = LISTpafA? name 
exit command = EXIT 

reset hardware command = RESET HARDWARE 

set/display rqgt command = RQGT ["= f CONTINUOUS H 

|_ t EMULATIONTIME J J 

display bus command =BUS 
cr = carriage-return line-feed 

IF Command 

if command = IF expr [THEN] cr true-list 

[ORIF expr [THEN] cr true-list] ... 
[ELSE cr false-list] 

true-list = [command cr] ... 

false-list = [command cr] ... 

end if = END 

Looping Commands 

repeat command = RE PEAT cr loop-list end-repeat 
end-repeat = END 

count command = COUNT expr-10 cr loop-list end-count 
expr-10 = expr 
end-count = END 
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loop-list = [loop element cr] ... 
loop element = command : : loop exit 
loop exit s WHILE EXPR : : UNTIL expr 

Macro Definition Command 

define macro command = DEFINE MACRO macro name cr macro body EM 
macro name = identifier 
macro body = [command cr] ... 

Macro Invocation Command 

macro invocation command = macro name : : [actual parameter list] 
actual parameter list = actual parameter factual parameter ] ... 
actual parameter = [limited token] ... '.'.string 
limited token = any token exceptor, sfr/r/o/ or "," 

Remove Macro Command 

remove macro command = REMOVE MACRO [macro //sf ] 
macro //sf = macro name [, macro name] ... 

Display Macro Command 

display macro command = MACRO [macro list] 

Enable/Disable Expansion Command 

enable/disable expansion command = J ENABLE | EXPANSION 

I DISABLE I 

Put Macro Command 

put macro command = PUT file name MACRO [macro list] 

Directory Command 

dir command = DIR directory 
directory = MACRO 

Include Command 

include command = INCLUDE file name 

Write Command 

write command = WRITE list element [, list element] ... 
list element = string : : expr : : BOOL expr 
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APPENDIX D 
ELECTRICAL AND PHYSICAL 
CHARACTERISTICS OF ICE-86A™ 



DC Characteristics of ICE-86A User Cable 



1. Output Low Voltages 

AD0-AD15 

A16/S3-A19/S7, BHE/S7, RD, LOCK, QSO, QS1, SO, S1, 
S2, WR, M/IO, DT/R, DEN, ALE, I NT A 

EMUL 

HLDA 

INITOUT 

MATCHO OR MATCH1 
RQ/GT 



V 0L (Max) l 0L (Max) 



0.4V 
0.5V 

0.4V 
0.5V 

0.4V 

0.4V 

0.25V 

0.4V 

0.4V 



12 mA 
24 mA 

8 mA 
16 mA 

16mA 

7 mA 

8mA 

16 mA 

16mA 



2. Output High Voltages 

AD0-AD15 

A16/S3-A19/S7, BHE/S7, RD, LOCK, QSO, QS1, SO, S1, 
S2, WR, M/IO, DT/R, DEN, ALE, INTA 

EMUL 

HLDA 

INITOUT 

MATCHO OR MATCH1 
RQ/GT 



V 0L (Min) 

2.4V 

2.4V 

4.5V 
2.4V 
3.1V 
2.4V 
4.5V 



l 0H (Max) 

- 3 mA 
-2.6 mA 

250mA 
-3.0 mA 

2.6mA 
-0.8 mA 

250mA 



3. Input Low Voltages 

AD0-AD15 
BRKEXT 
NMI, CLK 
READY 

INTR, HOLD, TEST, RESET 
MN/MX(0.1 fiftoGND) 



V |L (Max) 

0.8 V 
0.4V 
0.8V 
0.8V 
0.8V 
0.8V 



l IL (Max) 

-0.2 mA 
0.4mA 
-0.4 mA 
-0.8 mA 
-1.4 mA 
-3.3 mA 



4. Input High Voltages 

AD0-AD15 
BRKEXT 
NMI, CLK 
READY 

INTR, HOLD, TEST, RESET 
MN/MX 



V |H (Min) 

2.0V 
2.7V 
2.0V 
2.0 V 
2.0V 
2.0V 



l |L (Max) 

80 jiA 
20mA 
20 M A 
40 M A 
-0.4 m A 
-1.1 mA 
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Specifications 

ICE-86A Operating Environment 

Required Hardware: 

Intellec Microcomputer Development System with: 

1. Three adjacent slots for ICE-86A 

2. 64K of Intellec Memory. If expansion memory is desired, no more than 32K may be 16K 
RAM boards. 

System Console 

Intellec Diskette Operating System 
ICE-86A Module 

Required Software: 

System Monitor 

ISIS-II, Version 3.4 or subsequent 
ICE-86A Software 

Equipment Supplied 

Printed Circuit Boards (3) 

Interface Cable and Emulation Buffer Module 

Operator's Manual 

ICE-86A Software 

Emulation Clock 

User system clock up to 5 MHz or 2 MHz internal clock in stand-alone mode. 

Physical Characteristics 

Printed Circuit Boards: 

Width 12.00 in (30.48 cm) 

Height 6.75 in (17.15 cm) 

Depth 0.50 in ( 1.27 cm) 
Packaged Weight — — 

Electrical Characteristics 

+ 5V +5%-1% 
16A maximum; 11 A typical 
+ 12V±5% 

120 mA maximum; 80 mA typical 
-10V ±5% or -12V ± 5% (optional) 
15 mA maximum; 12 mA typical 

Environmental Characteristics 

Operating Temperature: 0° to 40°C 

Operating Humidity: Up to 95% relative humidity without condensation. 

NOTE 

The timing parameter TCL AZ has an actual transition of 85 ns for ICE-86A instead of 
80ns, as for the 8086 chip. 

The timing parameter TCL GH has an actual maximum value of 100 ns for ICE-86A 
instead of 85ns, as for the 8086 chip. 

All other timing parameters are as specified for the 8086 chip. 

HOLD/HOLDA Timing 

The diagrams below show the timing for the HOLD and HOLDA signals when the 
ICE-86A Module is in different modes of operation. During reset, byte/word/port 
commands and breakpoint loading, the worst case HOLDA response time is 1 
millisecond. Breakpoints are loaded at the beginning of each emulation that 
specifies a new break condition. 

During an emulation break, up to 1 millisecond may elapse before the ICE Module 
response to a HOLD input with a HOLDA signal. 

At no time does the ICE-86A Module truncate a user HOLD in progress. 



"cc 



'cc 
V 



DD 



'DD 

V 



BB 
BB 
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HOLD/HLDA TIMING 



1. ICE NOT IN EMULATION (INTERROGATION MODE): 



CPU CLOCK- 



USER HOLD 



HLDA 




2. ICE IN EMULATION: 



CPU CLOCK- 



USER HOLD 



,j~Lrynj~i_rL 
— ^ 



^Tj^n-TUT 




S2 S, Sq N USER WAIT STATES, 



HLDA 

3. DURING TIMES WHICH ICE REQUIRES EXCLUSIVE USE OF THE CPU TO EXECUTE ICE 
FUNCTIONS; I.E., RESET HARDWARE, BYTE/WORD/PORT COMMANDS, AND BREAK- 
POINT LOADING: 



USER HOLD 



HLDA 



_n n. 

_n n. 



n. 



. 800mSEC . 
MAXIMUM 



162554-19 



APPENDIX E 
INSTRUCTIONS IN 
HEXADECIMAL ORDER 



00 


00000000 


MOD REGR/M 


ADD 


EA,REG 


BYTE ADD (REG) TO EA 


01 


00000001 


MOD REGR/M 


ADD 


EA,REG 


WORD ADD (REG) TO EA 


02 


00000010 


MOD REGR/M 


ADD 


REG,EA 


BYTE ADD (EA) TO REG 


03 


00000011 


MOD REGR/M 


ADD 


REG,EA 


WORD ADD (EA) TO REG 


04 


00000100 




ADD 


AL,DATA8 


BYTE ADD DATA TO REG AL 


05 


00000101 




ADD 


AX, DAT A1 6 


WORD ADD DATA TO REG AX 


06 


00000110 




PUSH 


ES 


PUSH (ES) ON STACK 


07 


00000111 




POP 


ES 


POP STACK TO REG ES 


08 


00001000 


MOD REGR/M 


OR 


EA,REG 


BYTE OR (REG) TO EA 


09 


00001001 


MOD REGR/M 


OR 


EA,REG 


WORD OR (REG) TO EA 


OA 


00001010 


MOD REGR/M 


OR 


REG,EA 


BYTE OR (EA) TO REG 


OB 


00001011 


MOD REGR/M 


OR 


REG.EA 


WORD OR (EA) TO REG 


OC 


00001100 




OR 


AL.DATA8 


BYTE OR DATA TO REG AL 


OD 


00001101 




OR 


AX,DATA16 


WORD OR DATA TO REG AX 


OE 


00001110 




PUSH 


CS 


PUSH (CS) ON STACK 


OF 


00001111 




(not used) 






10 


00010000 


MOD REGR/M 


ADC 


EA.REG 


BYTE ADD (REG) W/ CARRY TO EA 


11 


00010001 


MOD REGR/M 


ADC 


EA,REG 


WORD ADD (REG) W/ CARRY TO EA 


12 


00010010 


MOD REGR/M 


ADC 


REA,EA 


BYTE ADD (EA) W/ CARRY TO REG 


13 


00010011 


MOD REGR/M 


ADC 


REG,EA 


WORD ADD (EA) W/ CARRY TO REG 


14 


00010100 




ADC 


AL,DATA8 


BYTE ADD DATA W/CARRY TO REG AL 


15 


00010101 




ADC 


AX.DATA16 


WORD ADD DATA W/ CARRY TO REG AX 


16 


00010110 




PUSH 


SS 


PUSH(SS) ON STACK 


17 


00010111 




POP 


SS 


POP STACK TO REG SS 


18 


00011000 


MOD REGR/M 


SBB 


EA,REG 


BYTE SUB (REG) W/ BORROW FROM EA 


19 


00011001 


MOD REGR/M 


SBB 


EA,REG 


WORD SUB (REG) W/ BORROW FROM EA 


1A 


00011010 


MOD REGR/M 


SBB 


REG,EA 


BYTE SUB (EA) W/ BORROW FROM REG 


1B 


00011011 


MOD REGR/M 


SBB 


REG.EA 


WORD SUB (EA) W/ BORROW FROM REG 


1C 


00011100 




SBB 


AL,DATA8 


BYTE SUB DATA W/ BORROW FROM REG AL 


1D 


00011101 




SBB 


AX,DATA16 


WORD SUB DATA W/ BORROW FROM REG AX 


1E 


00011110 




PUSH 


DS 


PUSH (DS) ON STACK 


1F 


00011111 




POP 


DS 


POP STACK TO REG DS 


20 


00100000 


MOD REGR/M 


AND 


EA,REG 


BYTE AND (REG) TO EA 


21 


00100001 


MOD REGR/M 


AND 


EA,REG 


WORD AND (REG) TO EA 


22 


00100010 


MOD REGR/M 


AND 


REG,EA 


BYTE AND (E A) TO REG 


23 


00100011 


MOD REGR/M 


AND 


REG,EA 


WORD AND (EA) TO REG 


24 


00100100 




AND 


AL.DATA8 


BYTE AND DATA TO REG AL 


25 


00100101 




AND 


AX,DATA16 


WORD AND DATA TO REG AX 


26 


00100110 




ES: 




SEGMENT OVERIDE W/ SEGMENT REG ES 


27 


00100111 




DAA 




DECIMAL ADJUST FOR ADD 


28 


00101000 


MOD REGR/M 


SUB 


EA,REG 


BYTE SUBTRACT (REG) FROM EA 


29 


00101001 


MOD REGR/M 


SUB 


EA,REG 


WORD SUBTRACT (REG) FROM EA 


2A 


00101010 


MOD REGR/M 


SUB 


REG,EA 


BYTE SU BTRACT (E A) FROM REG 


2B 


00101011 


MOD REGR/M 


SUB 


REG,EA 


WORD SUBTRACT (EA) FROM REG 


2C 


00101100 




SUB 


AL.DATA8 


BYTE SUBTRACT DATA FROM REG AL 


2D 


00101101 




SUB 


AX,DATA16 


WORD SUBTRACT DATA FROM REG AX 


2E 


00101110 




CS: 


SEGMENT OVERIDE W/ SEGMENT REG CS 


2F 


00101111 




DAS 




DECIMAL ADJUST FOR SUBTRACT 


30 


00110000 


MOD REGR/M 


XOR 


EA.REG 


BYTE XOR (REG) TO EA 


31 


00110001 


MOD REGR/M 


XOR 


EA.REG 


WORD XOR (REG) TO EA 


32 


00110010 


MOD REGR/M 


XOR 


REG.EA 


BYTE XOR (EA) TO REG 


33 


00110011 


MOD REGR/M 


XOR 


REG.EA 


WORD XOR (EA) TO REG 


34 


00110100 




XOR 


AL.DATA8 


BYTE XOR DATA TO REG AL 


35 


00110101 




XOR 


AX,DATA16 


WORD XOR DATA TO REG AX 


36 


00110110 




SS: 


SEGMENT OVERIDE W/ SEGMENT REG SS 


37 


00110111 




AAA 




ASCII ADJUST FOR ADD 


38 


00111000 


MOD REGR/M 


CMP 


EA.REG 


BYTE COMPARE (EA) WITH (REG) 


39 


00111001 


MOD REGR/M 


CMP 


EA,REG 


WORD COMPARE (EA) WITH (REG) 


3A 


00111010 


MOD REGR/M 


CMP 


REG,EA 


BYTE COMPARE (REG) WITH (EA) 


3B 


00111011 


MOD REGR/M 


CMP 


REG,EA 


WORD COMPARE (REG) WITH (EA) 


3C 


00111100 




CMP 


AL,DATA8 


BYTE COMPARE DATA WITH (AL) 


3D 


00111101 




CMP 


AX,DATA16 


WORD COMPARE DATA WITH (AX) 


3E 


00111110 




DS: 




SEGMENT OVERIDE W/ SEGMENT REG DS 


3F 


00111111 




AAS 




ASCII ADJUST FOR SUBTRACT 


40 


01000000 




INC 


AX 


INCREMENT (AX) 


41 


01000001 




INC 


CX 


INCREMENT (CX) 
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J A f\A AAAAJ A 

42 01000010 






INC 


DX 


INCREMENT (DX) 


43 01000011 






INC 


BX 


INCREMENT (BX) 


A A f\-A AAAJ AA 

44 01000100 






INC 


SP 


iki Ann ir lit /aa\ 

INCREMENT (SP) 


J f» A4 AAA^ A.4 

45 01000101 






INC 


BP 


ik 1 AAfi Ji*k i"F /aa\ 

INCREMENT (BP) 


46 01000110 






INC 


SI 


INCREMENT (SI) 


47 01000111 






INC 


Dl 


INCREMENT (Dl) 


J O A* A A4 AAA 

48 01001000 






DEC 


AX 


DECREMENT (AX) 


J A A .4 AAW AA-4 

49 01001001 






DEC 


CX 


DECREMENT (CX) 


4 A 01001010 






DEC 


DX 


DECREMENT (DX) 


a a A4 a a^ a «i 

4B 01001011 






DEC 


BX 


DECREMENT (BX) 


4C 01001100 






DEC 


SP 


DECREMENT (SP) 


A A AU A A .4 ,* /\ ^ 

4D 01001101 






DEC 


BP 


DECREMENT (BP) 


IT ft A AA4 .4 .4 A 

4E 01001110 






DEC 


SI 


DECREMENT (SI) 


4F 01001111 






DEC 


Dl 


DECREMENT (Dl) 


r- A aj A4 AAAA 

50 01010000 






PUSH 


AX 


HI ll>l 1 / A W V ATA !✓ 

PUSH (AX) ON STACK 


CM A4 A4AAA4 

51 01010001 






PUSH 


CX 


PUSH (CX) ON STACK 


it a a ^ /v ^ aa<4 a 

52 01010010 






PUSH 


DX 


PUSH (DX) ON STACK 


53 01010011 






PUSH 


BX 


PUSH (BX) ON STACK 


54 01010100 






PUSH 


SP 


m 1 A 1 1 /A A\ A A 1 AT" A 1/ 

PUSH (SP) ON STACK 


55 01010101 






PUSH 


BP 


A 1 1 A 1 1 / A A % /""N A 1 A T~ A 1/ 

PUSH (BP) ON STACK 


56 01010110 






PUSH 


SI 


Al IAI 1 / A l\ /*N k 1 AT A Al/ 

PUSH (SI) ON STACK 


C "f A-4 A«i A «4 4 4 

57 01010111 






PUSH 


Dl 


A 1 1 A 1 1 i A 1 V /"\ A 1 A A <lA 1/ 

PUSH (Dl) ON STACK 


fA AJ A*4 .4 AAA 

58 01011000 






POP 


AX 


Ai^% A A^T A aTWaW "T*^N P"> ^"N A V/ 

POP STACK TO REG AX 


PA A-* A ^ ^ A A«i 

59 01011001 






POP 


CX 


POP STACK TO REG CX 


CA A4 A4 4 A<4A 

5A 01011010 






POP 


DX 


POP STACK TO REG DX 


od 01011011 






POP 


BX 


POP STACK TO REG BX 


C A A4 A -4 A A AA 

5C 01011100 






POP 


SP 


POP STACK TO REG SP 


rn A4A444A4 

5D 01011101 






POP 


BP 


POP STACK TO REG BP 


5t 01011110 






POP 


SI 


POP STACK TO REG 01 


5F 01011111 






POP 


Dl 


OArt OTA -r-/~v nrA r\| 

POP STACK TO REG Dl 


CA A4 4 AAAAA 

60 01100000 






(not used) 






0-4 A A A AAAA4 

61 01100001 






(not used) 






AA A4 4 AAA<4 A 

62 01100010 






(not used) 






CO AH "1 AAA-4 4 

63 01100011 






(not used) 






fij A4 4AA4AA 

64 01100100 






(not used) 






ap A4 4AA4A4 

65 01100101 






(not used) 






A A AJ ^ AAJ ^ A 

66 01100110 






(not used) 






C7 f\4 4f\f\4 4 4 

67 01100111 






(not used) 






CO f\4 4 f\4 AAA 

68 01101000 






(not used) 






4 A^ AA<4 

69 01101001 






(not used) 






A * A4 4A4A4A 

6A 01101010 






(not used) 






6B 01101011 






(not used) 






6C 01101100 






(not used) 






A A A«i *4 A«i M A4 

6D 01101101 






(not used) 






6E 01101110 






(not used) 






6F 01101111 






(not used) 






~»A A.JJ 4 -4 AAAA 

70 01110000 






JO 


DISP8 


II II JA All Al/r~Ar~l A.IAI 

JUMP ON OVERFLOW 


71 01110001 






JNO 


DISP8 


ii 11 j a A.&, 1 k 1 at a.1 #r* nr*i a.i ai 

JUMP ON NOT OVERFLOW 


^A A -4 •« .4 AA«i A 

72 01110010 






JB/JNAE 


DISP8 


11 1 1 j n ai 1 r>r~ 1 At a # i a i at a r% At it— a i~» r- a i ■ a ■ 

JUMP ON BELOW/NOT ABOVE OR EQUAL 


TA A «4 4 .J AA«i «4 

73 01110011 






JNB/JAE 


DISP8 


11 11 in aii hat nr**i aiii / a aawt A.n r~Ai 1 a 1 

JUMP ON NOT BELOW/ ABOVE OR EQUAL 


7i A444A4AA 

74 01110100 






JE/JZ 


DISP8 


11 inn ah pai 1 a 1 1 ~rt~ r"»/~\ 

JUMP ON EQUAL/ZERO 


75 01110101 






JNE/JNZ 


DISP8 


11 inn All HAT f/NI 1 A 1 (HAT "rrnA 

JUMP ON NOT EQUAL/NOT ZERO 


7A A4 4 4 AU .4 /v 

76 01110110 






JBE/JNA 


DISP8 


11 111A aii r>r*i aiii a^i~» i-ai iai yiiAT a ns"\wr* 

JUMP ON BELOW OR EQUAL/NOT ABOVE 


~t~t f\A A A f\A A A 

77 01110111 






JNBE/JA 


DISP8 


11 inn aii mat 0 r~ 1 Atii An pai iai i a dawp 

JUMP ON NOT BELOW OR EQUAL/ABOVE 


■9A g\ at .J <<J <J AAA 

78 01111000 






JS 


DISP8 


1 1 1 ft A A j<"\ A 1 A tf \ A I 

JUMP ON SIGN 


1A A .4 4. +t <A A A<4 

79 01111001 






JNS 


DISP8 


II llin All HAT A 1 A 1 1 

JUMP ON NOT SIGN 


■y A A«i 4 J4 A4 A 

7A 01111010 






JP/JPE 


DISP8 


11 1 1 in aii a a niTU t n a niT\/ r\irn 

JUMP ON PARITY/PARITY EVEN 


*^a A -4 J J 4 A<4 <4 

7B 01111011 






JNP/JPO 


DISP8 


II I 1 A It A, || || /\T A A A IT\/ 1 A A A IT\/ A A A 

JUMP ON NOT PARITY/PARITY ODD 


TTA A4 AAAA AA 

7C 01111100 






JL/JNGE 


DISP8 


11 inn /*\i 1 1 f~oo 1 1 i^\t a a p~ a Tr a a p - ^\ 1 iai 

JUMP ON LESS/NOT GREATER OR EQUAL 


-7 1-\ AJ AAAA AJ 

7D 01111101 






JNL/JGE 


DISP8 


II III A All II AT 1 PAP lAAPATCn An PAI 1 A 1 

JUMP ON NOT LESS/GREATER OR EQUAL 


■»r~ aj j j ^ j j a 

7E 01111110 






JLE/JNG 


DISP8 


■ 1 inn /\ 1 ii r~ a a f\ a r— s~\ 1 iai in at a nr* aii n 

JUMP ON LESS OR EQUAL/NOT GREATER 


—9 1— A J J J J J J J 

7F 01111111 






JNLE/JG 


DISP8 


1 1 1 1 M A A 1 1 1 I /NT I P* A A /\ A 1— A I 1 A 1 f A AP* A Pf A 

JUMP ON NOT LESS OR EQUAL/GREATER 


AA J A AAAAA A 

80 10000000 


ft 1^P\ AAA 

MOD 000 


R/M 


ADD 


EA,DATA8 


AW 1 1 A A A A A T A TA r* A 

BYTE ADD DATA TO EA 


OA A A AAAA A A 

80 10000000 


MOD 001 


R/M 


OR 


EA.DATA8 


nwTP An n a t a ta c a 

BYTE OR DATA TO EA 


AA 1AAAAAAA 


MOD 010 


R/M 


AAA 

AUU 


CM, DA 1 Ao 


RYTP Ann DATA W / PARRY TO PA 
DTlCnUU UAIMW/ OMnnT IU CM 


80 10000000 


MOD 011 


R/M 


SBB 


EA.DATA8 


BYTE SUB DATA W/ BORROW FROM EA 


80 10000000 


MOD 100 


R/M 


AND 


EA,DATA8 


BYTE AND DATA TO EA 


80 10000000 


MOD 101 


R/M 


SUB 


EA,DATA8 


BYTE SUBTRACT DATA FROM EA 


80 10000000 


MOD 110 


R/M 


XOR 


EA,DATA8 


BYTE XOR DATA TO EA 


80 10000000 


MOD 111 


R/M 


CMP 


EA,DATA8 


BYTE COMPARE DATA WITH (EA) 


81 10000001 


MOD 000 R/M 


ADD 


EA,DATA16 


WORD ADD DATA TO EA 


81 10000001 


MOD 001 


R/M 


OR 


EA.DATA16 


WORD OR DATA TO EA 



E-2 



ICE-86A 



Instructions in Hexadecimal Order 



81 10000001 MOD 010 R/M 

81 10000001 MOD 011 R/M 

85 10000001 MOD 100 R/M 

81 10000001 MOD 101 R/M 

81 10000001 MOD 110 R/M 

81 10000001 MOD 111 R/M 

82 10000010 MOD 000 R/M 
82 10000010 MOD 001 R/M 
82 10000010 MOD 010 R/M 
82 10000010 MOD 011 R/M 
82 10000010 MOD 100 R/M 
82 10000010 MOD 101 R/M 
82 10000010 MOD 110 R/M 

82 10000010 MOD 111 R/M 

83 10000011 MOD 000 R/M 
83 10000011 MOD 001 R/M 
83 10000011 MOD 010 R/M 
83 10000011 MOD 011 R/M 
83 10000011 MOD 100 R/M 
83 10000011 MOD 101 R/M 
83 10000011 MOD 110 R/M 

83 10000011 MOD 111 R/M 

84 10000100 MOD REGR/M 

85 10000101 MOD REGR/M 

86 10000110 MOD REGR/M 

87 10000111 MOD REGR/M 

88 10001000 MOD REGR/M 

89 10001001 MOD REGR/M 
8A 10001010 MOD REGR/M 
8B 10001011 MOD REGR/M 
8C 10001100 MOD 0SRR/M 
8C 10001100 MOD 1— R/M 
8D 10001101 MOD REGR/M 
8E 10001110 MOD 0SR R/M 
8E 10001110 MOD — R/M 
8F 10001111 MOD 000 R/M 
8F 10001111 MOD 001 R/M 
8F 10001111 MOD 010 R/M 
8F 10001111 MOD 011 R/M 
8F 10001111 MOD 100 R/M 
8F 10001111 MOD 101 R/M 
8F 10001111 MOD 110 R/M 
8F 10001111 MOD 111 R/M 

90 10010000 

91 10010001 

92 10010010 

93 10010011 

94 10010100 

95 10010101 

96 10010110 

97 10010111 

98 10011000 

99 10011001 
9A 10011010 
9B 10011011 
9C 10011100 
9D 10011101 
9E 10011110 
9F 10011111 
A0 10100000 
A1 10100001 
A2 10100010 
A3 10100011 
A4 10100100 
A5 10100101 
A6 10100110 
A7 10100111 
A8 10101000 
A9 10101001 
AA101 01010 
AB10101011 
AC101 01100 



ADC 


FA DATA16 


CDD 
ODD 


FA nATAIfi 

CM, L/M 1 M IO 


AND 

MM L/ 


FA nATAIfi 

C AA, Ur\ 1 nlU 


SUB 


FA DATA16 




FA nATAIfi 

CM, Un 1 nlU 


CMP 


FA DATA16 


Ann 


FA nATAR 

tn, L/M 1 MO 


/not iiQPrU 




ADC 


FA DATA8 


ODD 


FA nATAft 

CM, Ur\ 1 MO 






SUB 


EA DAT Aft 


/not i KiPrH 
\l IUI uocu/ 




CMP 


FA DATA8 


Ann 

ML/Ls 


FA nATAft 

CM, Un 1 MO 


/ not i icoH\ 




Anc 


FA nATAR 

CM, L/M 1 MO 


CDD 
ODD 


FA nATAft 

CM, L/M 1 MO 


/not iiq£»H\ 
\\ iui uocu / 




CI ID 
OU D 


FA nATAft 

CM, L/M 1 MO 


\\ IUI uocu/ 




CMP 

WlVI 1 


FA nATAft 

CM, L/M 1 MO 


TF^T 
I to 1 


FA RFG 

CM, nc\3 


TF9T 


FA RFfi 
CM, nuu 


XCHG 


REG,EA 


AV/liVJ 


RFfi FA 

riCV3,CM 


MOV 


FA RFG 

cm, nc\ji 


MOV 


EA,REG 


IVIVJ V 


RFft FA 
ncvsi ,CM 


MOV 


REG,EA 


MOV 


EA,SR 


/not u^ed^ 




LEA 


REG,EA 


MOV 


SR,EA 


f not us^d) 




POP 


EA 


/ not i iq^H^ 

lllUl UOCU/ 




/ not i icori\ 

\l IUI UOCU/ 




/not i iqpH\ 
\l IUI uocu/ 




/not uc£kH\ 
\IIUl uocu/ 




/ not i iqoH\ 
\l IUI uocu/ 




/ not i icoHN 
VI iui uocu/ 




/ not i icoHN 
\iiui uocu/ 




Av/nva 


Ay Ay 

MA, MA 




Ay r.y 


Av^nva 


Ay ny 


Av/nva 


Ay Ry 

MA, DA 




Ay ^P 

MA, Or 


ypur; 


Ay RP 

MA,Dr 




Ay 

MAjOl 


AVjnu 


Ay ni 

MA, LSI 


HRW 




nwn 




fiAl 1 


ni^Pifi <%FGifi 

L/IOr 1 U,OLVJ IO 


WAIT 

VVMI 1 




pi ICUC 
ruonr 




POPF 




QAUC 

onnr 




1 AMF 

Lnnr 




MOV 
Ivlv/Y 


ai AnnRifi 

Ml_, ML/L/fi IO 


MOW 

IVIV^Y 


Ay AnnRifi 

nA,MuUn 1 0 


MOW 


AnnRifi ai 

nl/Un 1 O, ML. 


MOV 


AnnRifi Ay 

ML/L/rl IO,MA 


vnyj vo 


nQTft^RHft 

L/O 1 OOnvjO 


MOVS 


DST16 SRC16 

L/v/ 1 IWjvnwlW 


CMPS 


SIPTR,DIPTR 


CMPS 


SIPTR,DIPTR 


TEST 


AL.DATA8 


TEST 


AX,DATA16 


STOS 


DST8 


STOS 


DST16 


LODS 


SRC8 



WORD ADD DATA \NI CARRY TO EA 

WORD SUB DATA W/ BORROW FROM EA 

WORD AND DATA TO EA 

WORD SUBTRACT DATA FROM EA 

WORD XOR DATA TO EA 

WORD COMPARE DATA WITH (EA) 

BYTE ADD DATA TO EA 

BYTE ADD DATA W/ CARRY TO EA 
BYTE SUB DATA W/ BORROW FROM EA 

BYTE SUBTRACT DATA FROM EA 

BYTE COMPARE DATA WITH (EA) 
WORD ADD DATA TO EA 

WORD ADD DATA W/ CARRY TO EA 
WORD SUB DATA W/ BORROW FROM EA 

WORD SUBTRACT DATA FROM EA 

WORD COMPARE DATA WITH (EA) 

BYTE TEST (EA) WITH (REG) 

WORD TEST (EA) WITH (REG) 

BYTE EXCHANGE (REG) WITH (EA) 

WORD EXCHANGE (REG) WITH (EA) 

BYTE MOVE (REG) TO EA 

WORD MOVE (REG) TO EA 

BYTE MOVE (EA) TO REG 

WORD MOVE (EA) TO REG 

WORD MOVE (SEGMENT REG SR) TO EA 

LOAD EFFECTIVE ADDRESS OF EA TO REG 
WORD MOVE (EA) TO SEGMENT REG SR 

POP STACK TO EA 



EXCHANGE (AX) WITH (AX), (NOP) 

EXCHANGE (AX) WITH (CX) 

EXCHANGE (AX) WITH (DX) 

EXCHANGE (AX) WITH (BX) 

EXCHANGE (AX) WITH (SP) 

EXCHANGE (AX) WITH (BP) 

EXCHANGE (AX) WITH (SI) 

EXCHANGE (AX) WITH (Dl) 

BYTE CONVERT (AL) TO WORD (AX) 

WORD CONVERT (AX) TO DOUBLE WORD 

DIRECT INTER SEGMENT CALL 

WAIT FOR TEST SIGNAL 

PUSH FLAGS ON STACK 

POP STACK TO FLAGS 

STORE (AH) INTO FLAGS 

LOAD REG AH WITH FLAGS 

BYTE MOVE (ADDR) TO REG AL 

WORD MOVE (ADDR) TO REG AX 

BYTE MOVE (AL) TO ADDR 

WORD MOVE (AX) TO ADDR 

BYTE MOVE, STRING OP 

WORD MOVE, STRING OP 

COMPARE BYTE, STRING OP 

COMPARE WORD, STRING OP 

BYTE TEST (AL) WITH DATA 

WORD TEST (AX) WITH DATA 

BYTE STORE, STRING OP 

WORD STORE, STRING OP 

BYTE LOAD, STRING OP 



E-3 



Instructions in Hexadecimal Order 



ICE-86A 



AD10101101 






LODS 


SRC16 


WORD LOAD, STRING OP 


AE10101110 






SCAS 


DIPTR8 


BYTE SCAN, STRING OP 


AF10101111 






SCAS 


DIPTR16 


WORD SCAN, STRING OP 


B0 10110000 






MOV 


AL,DATA8 


BYTE MOVE DATA TO REG AL 


B1 10110001 






MOV 


CL,DATA8 


BYTE MOVE DATA TO REG CL 


B2 10110010 






MOV 


DL.DATA8 


BYTE MOVE DATA TO REG DL 


B3 10110011 






MOV 


BL,DATA8 


BYTE MOVE DATA TO REG BL 


B4 10110100 






MOV 


AH,DATA8 


BYTE MOVE DATA TO REG AH 


B5 10110101 






MOV 


CH,DATA8 


BYTE MOVE DATA TO REG CH 


B6 10110110 






MOV 


DH,DATA8 


BYTE MOVE DATA TO REG DH 


B7 10110111 






MOV 


BH,DATA8 


BYTE MOVE DATA TO REG BH 


B8 10111000 






MOV 


AX,DATA16 


WORD MOVE DATA TO REG AX 


B9 10111001 






MOV 


CX,DATA16 


WORD MOVE DATA TO REG CX 


BA10111010 






MOV 


DX,DATA16 


WORD MOVE DATA TO REG DX 


BB10111011 






MOV 


BX,DATA16 


WORD MOVE DATA TO REG BX 


BC10111100 






MOV 


SP,DATA16 


WORD MOVE DATA TO REG SP 


BD10111101 






MOV 


BP, DAT A1 6 


WORD MOVE DATA TO REG BP 


BE 10111110 






MOV 


SI,DATA16 


WORD MOVE DATA TO REG SI 


BF10111111 






MOV 


DI,DATA16 


WORD MOVE DATA TO REG Dl 


C0 11000000 






(not used) 






C1 11000001 






(not used) 






C2 11000010 






RET 


DATA16 


INTRA SEGMENT RETURN, ADD DATA TO REG SP 


C3 11000011 






RET 




INTRA SEGMENT RETURN 


C4 11000100 


MOD REGR/M 


LES 


REG.EA 


WORD LOAD REG AND SEGMENT REG ES 


C5 11000101 


MOD REGR/M 


LDS 


REG.EA 


WORD LOAD REG AND SEGMENT REG DS 


C6 11000110 


MOD 000 


R/M 


MOV 


EA,DATA8 


BYTE MOVE DATA TO EA 


C6 11000110 


MOD 001 


R/M 


(not used) 




C6 11000110 


MOD 010 


R/M 


(not used) 






C6 11000110 


MOD 011 


R/M 


(not used) 






C6 11000110 


MOD 100 


R/M 


(not used) 






C6 11000110 


MOD 101 


R/M 


(not used) 






C6 11000110 


MOD 110 


R/M 


(not used) 






C6 11000110 


MOD 111 


R/M 


(not used) 






C7 11000111 


MOD 000 


R/M 


MOV 


EA.DATA16 


WORD MOVE DATA TO EA 


C7 11000111 


MOD 001 


R/M 


(not used) 






C7 11000111 


MOD 010 


R/M 


(not used) 






C7 11000111 


MOD 011 


R/M 


(not used) 






C7 11000111 


MOD 100 


R/M 


(not used) 






C7 11000111 


MOD 101 


R/M 


(not used) 






C7 11000111 


MOD 110 


R/M 


(not used) 






C7 11000111 


MOD 111 


R/M 


(not used) 






C8 11001000 






(not used) 






C9 11001001 






(not used) 






CA11001010 






RET 


DATA16 


INTER SEGMENT RETURN, ADD DATA TO REG SP 


CB11001011 






RET 




INTER SEGMENT RETURN 


CC1 1001 100 






INT 


3 


TYPE 3 INTERRUPT 


CD11001101 






INT 


TYPE 


TYPED INTERRUPT 


CE11001110 






INTO 




INTERRUPT ON OVERFLOW 


CF 11001111 






IRET 




RETURN FROM INTERRUPT 


DO 11010000 


MOD 000 


R/M 


ROL 


EA,1 


BYTE ROTATE EA LEFT 1 BIT 


DO 11010000 


MOD 001 


R/M 


ROR 


EA,1 


BYTE ROTATE EA RIGHT 1 BIT 


D0 11010000 


MOD 010 


R/M 


RCL 


EA,1 


BYTE ROTATE EA LEFT THRU CARRY 1 BIT 


DO 11010000 


MOD 011 


R/M 


RCR 


EA,1 


BYTE ROTATE EA RIGHT THRU CARRY 1 BIT 


DO 11010000 


MOD 100 


R/M 


SHL 


EA,1 


BYTE SHIFT EA LEFT1 BIT 


DO 11010000 


MOD 101 


R/M 


SHR 


EA,1 


BYTE SHIFT EA RIGHT 1 BIT 


D0 11010000 


MOD 110 


R/M 


(not used) 




D0 11010000 


MOD 111 


R/M 


SAR 


EA,1 


BYTE SHIFT SIGNED EA RIGHT 1 BIT 


D1 11010001 


MOD 000 


R/M 


ROL 


EA,1 


WORD ROTATE EA LEFT 1 BIT 


D1 11010001 


MOD 001 


R/M 


ROR 


EA,1 


WORD ROTATE EA RIGHT 1 BIT 


D1 11010001 


MOD 010 


R/M 


RCL 


EA,1 


WORD ROTATE EA LEFT THRU CARRY 1 BIT 


D1 11010001 


MOD 011 


R/M 


RCR 


EA,1 


WORD ROTATE EA RIGHT THRU CARRY 1 BIT 


D1 11010001 


MOD 100 


R/M 


SHL 


EA,1 


WORD SHIFT EA LEFT 1 BIT 


D1 11010001 


MOD 101 


R/M 


SHR 


EA,1 


WORD SHIFT EA RIGHT 1 BIT 


D1 11010001 


MOD 110 


R/M 


(not used) 




D1 11010001 


MOD 111 


R/M 


SAR 


EA,1 


WORD SHIFT SIGNED EA RIGHT 1 BIT 


D2 11010010 


MOD 000 


R/M 


ROL 


EA,CL 


BYTE ROTATE EA LEFT (CL) BITS 


D2 11010010 


MOD 001 


R/M 


ROR 


EA.CL 


BYTE ROTATE EA RIGHT (CL) BITS 


D2 11010010 


MOD 010 


R/M 


RCL 


EA,CL 


BYTE ROTATE EA LEFT THRU CARRY (CL) BITS 


D2 11010010 


MOD 011 


R/M 


RCR 


EA,CL 


BYTE ROTATE EA RIGHT THRU CARRY (CL) BITS 


D2 11010010 


MOD 100 


R/M 


SHL 


EA.CL 


BYTE SHIFT EA LEFT (CL) BITS 


D2 11010010 


MOD 101 


R/M 


SHR 


EA,CL 


BYTE SHIFT EA RIGHT (CL) BITS 


D2 11010010 


MOD 110 


R/M 


(not used) 




D2 11010010 


MOD 111 


R/M 


SAR 


EA,CL 


BYTE SHIFT SIGNED EA RIGHT (CL) BITS 



E-4 
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Instructions in Hexadecimal Order 



D3 11010011 


MOD 000 


R/M 


ROL 


EA,CL 


WORD ROTATE EA LEFT (CL) BITS 


D3 11010011 


MOD 001 


R/M 


ROR 


EA.CL 


WORD ROTATE EA RIGHT (CL) BITS 


D3 11010011 


MOD 010 


R/M 


RCL 


EACL 


WORD ROTATE EA LEFT THRU CARRY (CL) BITS 


D3 11010011 


MOD 011 


R/M 


RCR 


EA,CL 


WORD ROTATE EA RIGHT THRU CARRY (CL) BITS 


D3 11010011 


MOD 100 


R/M 


SHL 


EA,CL 


WORD SHIFT EA LEFT (CL) BITS 


D3 11010011 


MOD 101 


R/M 


SHR 


EA,CL 


WORD SHIFT EA RIGHT (CL) BITS 


D3 11010011 


MOD 110 


R/M 


(not used) 






D3 11010011 


MOD 111 


R/M 


SAR 


EA,CL 


WORD SHIFT SIGNED EA RIGHT (CL) BITS 


D4 11010100 


00001010 




AAM 




ASCII ADJUST FOR MULTIPLY 


D5 11010101 


00001010 

ww ww 1 V ■ w 




ADD 




ASCII ADJUST FOR DIVIDE 


D6 11010110 

L-/ w 1 1 V 1 V 1 1 V 






(not used) 


Table 




D7 11010111 






XL AT 


TRANSLATE USING (BX) 


D8 11011 — 


MOD — 


R/M 


ESC 


EA 


ESCAPE TO EXTERN AL DEVICE 


E0 11100000 






LOOPNZ/LOOPNE DISP8 


LOOP (CX) TIMES WHILE NOT ZERO/NOT EQUAL 


E1 11100001 

L— 1 III vwUv 1 






LOOPZ/LOOPE DISP8 


LOOP (CX) TIMES WHILE ZERO/ EQUAL 


E2 11100010 

Ufa III V ww 1 V 






LOOP 


DISP8 


LOOP (CX) TIMES 


E3 11100011 






JCXZ 


DISP8 


JUMP ON (CX)=0 


E4 11100100 

V- ~ III vv 1 ww 






IN 


A L, PORT 


BYTE INPUT FROM PORT TO REG AL 


E5 11100101 






IN 


AX, PORT 


WORD INPUT FROM PORT TO REG AX 


E6 11100110 

Uv III WW 1 1 w 






OUT 


PORT, A L 


BYTE OUTPUT (AL) TO PORT 


E7 11100111 






OUT 


PORT^AX 


WORD OUTPUT (AX) TO PORT 


E8 11101000 






CALL 


DISP16 


DIRECT INTRA SEGMENT CALL 


E9 11101001 






JMP 


DISP16 


DIRECT INTRA SEGMENT JUMP 


EA1 11 01010 






JMP 


DISP16 SEG16 


DIRECT INTER SEGMENT JUMP 


EB11101010 






JMP 


DISP8 


DIRECT INTRA SEGMENT JUMP 


EC11101010 






IN 


AL,DX 


BYTE INPUT FROM PORT (DX) TO REG AL 


ED11101010 






IN 


AX,DX 


WORD INPUT FROM PORT (DX) TO REG AX 


EE11101010 






OUT 


DX^AL 


BYTE OUTPUT (AL) TO PORT (DX) 


EF 11101010 






OUT 


DX^AX 


WORD OUTPUT (AX) TO PORT (DX) 


F0 11110000 






LOCK 




BUS LOCK PREFIX 


F1 11110001 






(not usecH 






F2 11110010 






REPNZ 




REPEAT WHILE (CX)^O AND (ZF)=0 


F3 11110011 






REPN 




REPEAT WHILE (CX)*0 AND (ZF)=1 


F4 11110100 






HLT 




HALT 


F5 11110101 






CMC 




COMPLEMENT CARRY FLAG 


F6 11110110 


MOD 000 


R/M 


TEST 


EA DATA8 


BYTE TEST (E A) WITH DATA 


F6 11110110 


MOD 001 


R/M 


(not used) 






F6 11110110 


MOD 010 


R/M 


NOT 


EA 


BYTE INVERT EA 


F6 11110110 


MOD 011 


R/M 


NEG 


EA 


BYTE NEGATE EA 


F6 11110110 


MOD 100 


R/M 


MUL 


EA 


BYTE MULTIPLY BY (EA), UNSIGNED 


F6 11110110 


MOD 101 


R/M 


IMUL 


EA 


BYTE MULTIPLY BY (EAK SIGNED 


F6 11110110 


MOD 110 


R/M 


DIV 


EA 


BYTE DIVIDE BY (EA), UNSIGNED 


F6 11110110 


MOD 111 


R/M 


ID IV 


EA 


BYTE DIVIDE BY (EA)| SIGNED 


F7 11110111 


MOD 000 


R/M 


TEST 


EA,DATA16 


WORD TEST (EA) WITH DATA 


F7 11110111 


MOD 001 


R/M 


(not used^ 






F7 11110111 


MOD 010 


R/M 


NOT 


EA 


WORD INVERT EA 


F7 11110111 


MOD 011 


R/M 


NEG 


EA 


WORD NEGATE EA 


F7 11110111 


MOD 100 


R/M 


MUL 


EA 


WORD MULTIPLY BY (EA), UNSIGNED 


F7 11110111 

1 1 IIIIV/lll 


MOD 101 

1 VI V-/ l_S 1 W 1 


R/M 


IMUL 


EA 


WORD MULTIPLY BY (EA), SIGNED 


F7 11110111 


MOD 110 


R/M 


DIV 


EA 


WORD DIVIDE BY (EA), UNSIGNED 


F7 11110111 


MOD 111 


R/M 


IDIV 


EA 


WORD DIVIDE BY (EA), SIGNED 


F8 11111000 






CLC 




CLEAR CARRY FLAG 


F9 11111001 






STC 




SET CARRY FLAG 


FA 11111010 






CLI 




CLEAR INTERRUPT FLAG 


FB11111011 






STI 




SET INTERRUPT FLAG 


FC11111100 






CLD 




CLEAR DIRECTION FLAG 


FD 11111101 






STD 




SET DIRECTION FLAG 


FE 11111110 


MOD 000 


R/M 


INC 


EA 


BYTE INCREMENT EA 


FE11111110 


MOD 001 


R/M 


DEC 


EA 


BYTE DECREMENT EA 


FE 11111110 


MOD 010 


R/M 


(not used) 






FE 11111110 


MOD 011 


R/M 


(not used) 






FE 11111110 


MOD 100 


R/M 


(not used) 






FE 11111110 


MOD 101 


R/M 


(not used) 






FE 11111110 


MOD 110 


R/M 


(not used) 






FE 11111110 


MOD 111 


R/M 


(not used) 






FF 11111111 


MOD 000 


R/M 


INC 


EA 


WORD INCREMENT EA 


FF 11111111 


MOD 001 


R/M 


DEC 


EA 


WORD DECREMENT EA 


FF 11111111 


MOD 010 


R/M 


CALL 


EA 


INDIRECT INTRA SEGMENT CALL 


FF 11111111 


MOD 011 


R/M 


CALL 


EA 


INDIRECT INTER SEGMENT CALL 


FF 11111111 


MOD 100 


R/M 


JMP 


EA 


INDIRECT INTRA SEGMENT JUMP 


FF 11111111 


MOD 101 


R/M 


JMP 


EA 


INDIRECT INTER SEGMENT JUMP 


FF 11111111 


MOD 110 


R/M 


PUSH 


EA 


PUSH (EA) ON STACK 


FF 11111111 


MOD 111 


R/M 


(not used) 







Instructions in Hexadecimal Order 



REG IS ASSIGNED ACCORDING TO THE FOLLOWING TABLE: 

16-BIT (W=1) 8-BIT (W=0) SEGMENTREG 

000 AX 000 AL 00 ES 

001 CX 001 CL 01 CS 

010 DX 010 DL 10 SS 

011 BX 011 BL 11 DS 

100 SP 100 AH 

101 BP 101 CH 

110 SI 110 DH 

111 Dl 111 BH 



EA IS COMPUTED AS FOLLOWS: (DISP8 SIGN EXTENDED T0 16 BITS) 



00 


000 


(BX) + (SI) 


DS 


00 


001 


(BX) + (DI) 


DS 


00 


010 


(BP) + (SI) 


SS 


00 


011 


(BP) + (DI) 


SS 


00 


100 


(SI) 


DS 


00 


101 


(Dl) 


DS 


00 


110 


DISP16 (DIRECT ADDRESS) 


DS 


00 


111 


(BX) 


DS 


01 


000 


(BX) + (SI) + DISP8 


DS 


01 


001 


(BX) + (DI) + DISP8 


DS 


01 


010 


(BP) + (SI) + DISP8 


SS 


01 


011 


(BP) + (DI) + DISP8 


SS 


01 


100 


(SD + DISP8 


DS 


01 


101 


(DD + DISP8 


DS 


01 


110 


(BP) + DISP8 


SS 


01 


111 


(BX) + DISP8 


DS 


10 


000 


(BX) + (SI) + DISP16 


DS 


10 


001 


(BX) + (DI) + DISP16 


DS 


10 


010 


(BP) + (SI) + DISP16 


SS 


10 


011 


(BP) + (DI) + DISP16 


SS 


10 


100 


(SD + DISP16 


DS 


10 


101 


(DD + DISP16 


DS 


10 


110 


(BP) + DISP16 


SS 


10 


111 


(BX) + DISP16 


DS 


11 


000 


REG AX / AL 




11 


001 


REG CX / CL 




11 


010 


REG DX / DL 




11 


011 


REG BX / BL 




11 


100 


REG SP / AH 




11 


101 


REG BP / CH 




11 


110 


REG SI / DH 




11 


111 


REG Dl / BH 





FLAGS REGISTER CONTAINS: 



X:X:X:X:(OF):(DF):(IF):(TF):(SF):(ZF):X:(AF):X:(PF):X:(CF) 



ICE-86A 



Instructions in Hexadecimal Order 



8086 INSTRUCTION 



SET MATRIX 



Lo 



Lo 



m V 
Hi \ 


0 


1 


2 


3 


4 


5 


6 


7 


Hi \ 

\ 


8 


9 


A 


B 


C 


D 


E 


F 


o 


ADD 

b.f.r/m 


ADD 

w.f.r/m 


ADD 

b.t.r/m 


ADD 

w.t.r/m 


ADD 

b. ia 


ADD 

w. ia 


PUSH 
ES 


POP 

ES 


0 


OR 

b.f.r/m 


OR 
w.f.r/m 


OR 
b.t.r /m 


OR 

w.t,r/m 


OR 

b.i 


OR 

W.I 


PUSH 

PC 

I/O 




i 


ADC 

b.f.r/m 


ADC 
w.f.r/m 


ADC 

b.t.r/m 


ADC 

w.t.r/m 


ADC 

b.i 


ADC 

w.i 


PUSH 

SS 


POP 

SS 


1 


SBB 

b.f.r/m 


SBB 

w.f.r/m 


SBB 
b.t.r/m 


SBB 

w.t,r/m 


SBB 

b.i 


SBB 

w.i 


PUSH 
DS 


POP 
DS 


2 


AND 

b.t.r/m 


AND 

w.f.r/m 


AND 

b.t.r/m 


AND 

w.t.r/m 


AND 

b.i 


AND 

w.i 


SEG 
ES 


DAA 


2 


SUB 

b.f.r/m 


SUB 

w.f,r/m 


SUB 

b.t,r/m 


SUB 
w.t,r/m 


SUB 
b.i 


SUB 

w.i 


SEG 

PC 


DAS 


3 


XOR 

b.f .r /m 


XOR 

w.f.r/m 


XOR 

b.t.r/m 


XOR 

w.t.r/m 


XOR 

b.i 


XOR 

w.i 


SEG 
SS 


AAA 


3 


CMP 

b.f.r/m 


CMP 

w.f.r/m 


CMP 

b.t.r/m 


CMP 

w.t.r/m 


CMP 

b,i 


CMP 

w.i 


SEG 
nc 


AAS 


4 


INC 
AX 


INC 

CX 


INC 

DX 


INC 

BX 


INC 

SP 


INC 
BP 


INC 

SI 


INC 
Dl 


4 


DEC 
AX 


DEC 
CX 


DEC 
DX 


DEC 
BX 


DEC 
SP 


DEC 
BP 


DEC 
SI 


DEC 
Dl 


5 


PUSH 
AX 


PUSH 
CX 


PUSH 
DX 


PUSH 
BX 


PUSH 
SP 


PUSH 
BP 


PUSH 
SI 


PUSH 
Dl 


5 


POP 
AX 


POP 
CX 


POP 
DX 


POP 
BX 


POP 
SP 


POP 
BP 


POP 

SI 


POP 
Dl 


6 


















6 


















7 


JO 


JNO 


JB/ 
JNAE 


JNB/ 
JAE 


JE/ 
JZ 


JNE/ 
JNZ 


JBE/ 
JNA 


JNBE/ 
JA 


7 


JS 


JNS 


JP/ 
JPE 


JNP/ 
JPO 


JL/ 
JNGE 


JNL/ 
JGE . 


JLE / 
JNG 


JNLE/ 
JG 


8 


Immed 

b.r/m 


Immed 
w.r/m 


Immed 

b.r/m 


Immed 

is.r/m 


TEST 
b.r/m 


TEST 
w.r/m 


XCHG 
b.r/m 


XCHG 
w.r/m 


8 


MOV 

b.f.r/m 


MOV 

w.f.r/m 


MOV 

b.t.r/m 


MOV 

w.t.r/m 


MOV 

sr,f,r/m 


LEA 


MOV 

sr,t,r/m 


POP 

r/m 


9 


XCHG 
AX 


XCHG 


XCHG 

UA 


XCHG 

RY 
DA 


XCHG 

CD 

or 


XCHG 

DO 

or 


XCHG 

CI 


XCHG 
Dl 


9 


CBW 


CWD 


CALL 
l.d 


WAIT 


PUSHF 


POPF 


SAHF 


LAHF 


A 


MOV 

m ~AL 


MOV 

m - AX 


MOV 

AL - m 


MOV 

AX - m 


MOVS 


MOVS 


CMPS 


CMPS 


A 


TEST 
b,U 


TEST 
w,i,a 


STOS 


STOS 


LODS 


LODS 


SCAS 


SCAS 


B 


MOV 

i - AL 


MOV 

i - CL 


MOV 

i - DL 


MOV 

i - BL 


MOV 

i - AH 


MOV 

i - CH 


MOV 

i - DH 


MOV 

i - BH 


B 


MOV 

i - AX 


MOV 

i - CX 


MOV 

i - DX 


MOV 

i - BX 


MOV 

i - SP 


MOV 

i - BP 


MOV 

i - SI 


MOV 

i - Dl 


C 






RET. 
(i+SP) 


RET 


LES 


LDS 


MOV 

b,i.r/m 


MOV 

w.i.r/m 


C 






RET. 
l.(i*SP) 


RET 
I 


INT 
Type 3 


INT 

(Any) 


INTO 


IRET 


0 


Shift 
b 


Shift 
w 


Shift 
b.v 


Shift 
w.v 


AAM 


AAD 




XLAT 


D 


ESC 
0 


ESC 
1 


ESC 

2 


ESC 
3 


ESC 
4 


ESC 
5 


ESC 
6 


ESC 

7 


E 


LOOPNZ/ 
LOOPNE 


LOOPZ/ 
LOOPE 


LOOP 


JCXZ 


IN 
b 


IN 
w 


OUT 
b 


OUT 
w 


E 


CALL 
d 


JMP 
d 


JMP 

l.d 


JMP 

si.d 


IN 

v,b 


IN 

v,w 


OUT 

v,b 


OUT 
v,w 


F 


LOCK 




REP 


REP 
Z 


HLT 


CMC 


Grp 1 

b.r/m 


Grp1 
w.r/m 


F 


CLC 


STC 


CLI 


STI 


CLD 


STD 


Grp 2 

b.r/m 


Grp 2 
w.r/m 



mod[~lr/m 


000 


001 


010 


011 


100 


101 


110 


111 


Immed 


ADO 


OR 


ADC 


SBB 


AND 


SUB 


XOR 


CMP 


Shift 


ROL 


ROR 


RCL 


RCR 


SHL/SAL 


SHR 




SAR 


Grp 1 


TEST 




NOT 


NEG 


MUL 


IMUL 


OIV 


IDIV 


Grp 2 


INC 


DEC 


CALL 
id 


CALL 

l.id 


JMP 

id 


JMP 

lid 


PUSH 





b = byte operation 

d - direct 

f = from CPU reg 

i = immediate 

ia = immed. to accum. 

id = indirect 

is = immed. byte, sign ext. 
I = long ie. intersegment 



m = memory 

r/m = EA is second byte 

si = short intrasegment 

sr - segment register 

t = to CPU reg 

v - variable 

w = word operation 

z = zero 
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APPENDIX F 
iSBC 86/12™ AND iSBC 86/12A™ FIX 



ICE-86A may produce an error in reading a single byte when ICE-86A is used with 
an iSBC 86/12 or iSBC 86/12A Single Board Computer. A spurious error can occur 
in a data byte read from an odd memory location in the iSBC 86/12 or iSBC 
86/12A. The error is caused by a change in the even byte signals while the read signal 
is active at the interface between ICE-86A and iSBC 86/12. As a result the lower 
byte and upper byte data lines may cross-couple in the ICE-86A user cable during a 
single byte read operation. A similar error condition exists for I/O operations. 

The noise interference during the reading of odd memory locations can be 
eliminated by locating 10K ohm resistors on the iSBC 86/12 or the iSBC 86/12A. 
These resistors guarantee that the even byte data lines will be in a stable logic state. 
To eliminate the read interference, it is recommended that a 10K ohm resistor pack 
be mounted to pins 1 through 8 of a 20 pin I.C. test clip with pin 20 wired to the 
resistor pack as a +5V source as shown in figure F-2. Attach the test clip to the 8287 
Octal Bus Transceiver at A69 (see figures F-1 (a), F-3, and F-4). This will pull up the 
lower data lines during read operations of upper data bytes. 

To eliminate noise interference during I/O cycles, two solutions are recommended. 
The first solution can be used with either the iSBC 86/12 or an iSBC 86/12A that 
does not contain an iSBC 340 Multimodule EPROM Expansion Board. Mount a 
10K ohm resistor pack on a 20 pin I.C. test clip, pins 1 through 8 with pin 20 wired 
to the resistor pack as a +5V source as shown in figure F-2. Attach the test clip to the 
8286 Octal Bus Transceiver located at A45 (see figures F-l(b), F-3, and F-4). 

The second solution to I/O noise interference must be used with an iSBC 86/12A 
containing an iSBC 340 module EPROM Expansion Board. Mount 10K resistors on 
a 24 pin I.C. test clip, pins 9, 10, 11, and pins 13 through 17 with the resistors wired 
to pin 24 as a +5V source. Attach the test clip to the EPROM located at A46 on the 
iSBC 340 (see figures F-l(b), F-3, and F-5). 

By adding these two test chips to the iSBC board, the floating data lines will be 
pulled up and the cross-coupling between even and odd byte data lines will be 
eliminated. 

NOTE 

This problem does not exist when ICE-86A is used with other user circuits, 
or when iSBC 86/12 or iSBC 86/12A is used without 1CE-86A. 



F-1 



iSBC 86/12 and iSBC 86/12A Fix 



ICE-86A 



(a) 



(b) 



+ 5V 



+ 5V 





> 10K 




> 10K 




[ 10K 




[ 10K 




► 10K 

' 




[ 10K 




► 10K 




; iok 

; 





DM7 A69-1 



DM6 A69-2 



DM5 A69-3 



DM4 A69-4 



DM3 A69-5 



DM2 A69-6 



DM1 A69-7 



DMO A69-6 







> 10K 


> 10K 




> 10K 




I 10K 




I 10K 




— : 

I 10K 




; 10K 








; iok 





DB8 A45-1,OR 
A46-9 



DB9 A45-2, OR 
A46-10 



DBA A45-3, OR 
A46-11 



DBB A45-4, OR 
A46-13 



DBC A45-5, OR 
A46-14 



DBD A45-6, OR 
A46-15 



DBE A45-7, OR 
A46-16 



DBF A45-8, OR 
A46-17 



Figure F-l . The Piggyback Circuits Locations A45, A46, A69 of 

iSBC 86/12™ and iSBC86/12A™ 162554-1 
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iSBC 86/12 and iSBC 86/12A Fix 




Figure F-2. Typical Application of I.C. Test Clips 
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Figure F-3. iSBC 86/ 12 A™ Parts Location Diagram 
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Figure F-4. iSBC 86/12A™ Schematic Diagram 
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Figure F-5. iSBC 86/ 12 A™ Schematic Diagram 
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APPENDIX G 
GUIDELINES FOR USE OF 
CLOCK, READY, AND RWTIMEOUT 



This appendix provides detailed information on use of the CLOCK, READY, and 
RWTIMEOUT commands. In this appendix, the term "Intel memory" refers to 
memory mapped to ICE RAM, Intellec expansion RAM, and/or disk storage. 



Set CLOCK Command 



The 8086 requires a clock signal input to provide a timing reference for all CPU 
activities. The ICE-86A emulator allows the clock signal to be supplied by either the 
user system or the ICE hardware. The source of the clock signal is determined by the 
set CLOCK command (CLOCK = INTERNAL or CLOCK = EXTERNAL). 

The command CLOCK = EXTERNAL is entered to select the user system clock 
signal to the 8086. An active user system clock must be present once this command is 
entered or the 8086 will not function. 

The 8086 read/write commands, which are generated for each bus cycle, are sent out 
to the user system when an external clock is selected. Therefore CLOCK must be set 
to external (and an active user system clock signal must be present) whenever any 
block of logical memory is mapped to the user system to ensure that the 8086 com- 
mand signals reach the memory components in the user system. 

Since the ICE-86A emulator assumes that all referenced I/O ports exist in the user 
system, CLOCK must be set to EXTERNAL (and an active user clock signal must be 
present) for I/O operations to ensure that the 8086 commands reach the port 
devices. This is true whether I/O ports are accessed directly or when emulating user 
code. 

There are some situations when it is desirable to set CLOCK to EXTERNAL even 
though all logical memory is mapped to Intel memory. Hardware debugging of a 
malfunctioning user system is one case where this combination of clock selection 
and memory mapping may be useful. The 8086 can execute code stored in Intel 
memory while the command signals can be observed in the malfunctioning user 
system. The only part of the user system that must be functioning properly during 
this debugging is the clock circuit. 

Near real time emulation of user code is another case where it may be useful to select 
an external clock even though all logical memory is mapped to Intel memory. Since 
the only part of the user system that must be present during this emulation is the 
clock circuit, software debugging at near real time speeds can begin before a com- 
plete user system is available. 

The command CLOCK = INTERNAL is entered to select the 2-MHz ICE-86A 
emulator clock signal to the 8086. The 8086 command signals are not available to the 
user system and no user clock signal is required when the internal clock is selected. 

The internal emulator clock is typically selected when the ICE-86A emulator is used 
as a standalone software debugger or when all logical memory is mapped to Intel 
memory. It should be noted, however, that emulation with the 2-MHz ICE emulator 
clock signal may execute more slowly than with the faster clock signal usually found 
in a user system. 
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ENABLE/DISABLE RDY Command 

The READY input to the 8086 allows interfacing the CPU to memory or I/O where 
the access time of the memory or I/O is slower than the CPU bus cycle. 

The ready signal is typically generated by acknowledge circuitry after an address has 
been decoded, but before the addressed location has been accessed. The 8086 CPU 
samples its READY input midway during each bus cycle. The processor proceeds 
with the bus cycle if an active ready signal is available at this sample time. However, 
if the ready signal is not active at sample time, the 8086 injects wait states into the 
bus cycle indefinitely until an active ready signal is detected. These wait states allow 
the 8086 CPU to be synchronized to slower memory or I/O. 

The ENABLE/DISABLE RDY command allows the user of the ICE-86A emulator 
to enable or disable the ready signal generated by the user system during read/write 
operations to Intel memory. The difference between the two modes of operation 
(ENABLE RDY and DISABLE RDY) is shown in simplified logic in figure G-l . 

In the ENABLE RDY mode, the ICE-86A emulator logically ANDs the user system 
ready signal with the ready signal from Intel memory for all memory operations. In 
the DISABLE RDY mode, the ready signal is provided by the emulator alone when 
accessing Intel memory; the emulator continues to AND the user system ready signal 
with the ready signal from Intel memory when accessing user system memory. 

The ENABLE RDY mode should be used during normal operation. In this mode, 
the 8086 CPU waits for both the user ready signal and the ICE emulator ready signal 
for all memory operations. Waiting for the user ready signal is necessary to avoid 
problems that may arise when user system memory is slower than Intel memory or is 
implemented with dynamic RAM devices. The following example describes such a 
problem. 

Assume two back-to-back memory cycles where the first cycle is to Intel memory 
and the second access is to user system memory. If the DISABLE RDY mode is 
used, the 8086 can complete the first cycle to Intel memory and begin the second 
cycle to user memory independent of the user ready signal. If the user memory is 
much slower than Intel memory or is in a refresh cycle, it may not have responded 
to/ recovered from the first cycle when the second cycle begins. 



MEMORY ACCESS 


ENABLE RDY 


DISABLE RDY 


USER SYSTEM 
MEMORY ACCESS 


USER 

' j A_ 8086 

ICE 1 J READY 


USER 

1 1 A_ 8086 

ICE 1 J READY 


INTEL 
MEMORY ACCESS 
(ICE, INTELLEC, 
OR DISK) 


USER 

' 1 V_ 8086 

ICE 1 J READY 


,+5V 

' 1 V 8086 

ICE 1 J READY 



Figure G-l . Source of 8086 READY Input 162554-9 
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Guidelines for use of CLOCK, READY, and RWTIMEOUT 



If the ENABLE RDY mode is used, the second cycle cannot begin until both Intel 
memory and user memory are ready. 

The ICE-86A emulator is in the ENABLE RDY mode at initialization. 

The DISABLE RDY mode is typically selected (1) when the ICE-86A emulator is 
used as a standalone software debugger (no user system present); or (2) when the 
user system is being designed/debugged (no ready signal is being generated by the 
user system and/or a portion of program memory is mapped to Intel memory). In 
the DISABLE RDY mode, the ICE-86A emulator does not wait for the user ready 
signal for memory cycles to Intel memory. 



Set RWTIMEOUT Command 

In emulation mode, an 8086 bus cycle to Intel memory may take up to a few 
milliseconds, although it may take longer when a disk access is required. (The 2K of 
ICE-86A emulator RAM, however, is very fast.) The read/write command signals 
are active for approximately the entire cycle. When CLOCK is set to EXTERNAL, 
the read/write commands are also active in the user system for the same period of 
time. This may cause problems with user system dynamic RAM devices such as 
2117s and 2118s. These RAM devices require a complete refresh cycle every 2 
milliseconds to guarantee data retention. The devices may lose their data if a refresh 
cycle is delayed due to command signals that are active on the user system for over 2 
milliseconds. 

The RWTIMEOUT command is used to deactivate the read/write command signals 
to the user memory after a time limit specified by the user of the ICE-86A emulator. 
This time limit allows the user memory refresh circuitry to proceed as required. 

The default value of RWTIMEOUT is 1000 microseconds, but can be changed by 
the ICE emulator user to any value greater than 0 and less than 32,000 or 
INFINITE. The command RWTIMEOUT = 500, for example, deactivates the 
read/write command signals to user memory 500 microseconds after a memory cycle 
begins, even though the cycle to Intel memory is still in progress. 



Dynamic RAM devices with a 2 millisecond refresh cycle specification will 
typically hold data for much longer periods of time without refresh; 
sometimes for several seconds. Therefore an ICE-86A emulator user may 
set RWTIMEOUT = INFINITE and still observe no problems in user 
memory, even when accessing memory mapped to disk (5 milliseconds is 
typical for disk access, but some disk operations may take several seconds). 
However, not all RAM devices will hold data past the 2 millisecond limit. 
Loss of data may result when this limit is exceeded. It is recommended that 
RWTIMEOUT never exceed 10 milliseconds. 

If ERROR is specified in the RWTIMEOUT command, the ICE-86A emulator 
checks the user system ready signal and reports timeouts to the user. For example, if 
the command RWTIMEOUT = 1000 ERROR is entered, a ready timeout is reported 
during emulation if no user ready is received within 1000 microseconds of the start 
of a memory cycle. RWTIMEOUT = 1000 ERROR is a useful setting when Intellec 
and disk memory are not accessed. 

If Intellec and/or disk memory are used, the recommended setting is RWTIMEOUT 
= 1000 NOERROR. Read/write commands to the user system are terminated 1000 
microseconds after the start of a memory cycle, but the emulator does not report 
ready time-outs which may otherwise occur during access to Intellec or disk 
memory. 
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Summary of CLOCK, READY, and RWTIMEOUT 

Table G-l illustrates the possible combinations of the CLOCK and 
ENABLE/DISABLE RDY commands for various memory mappings. The discus- 
sion below summarizes the guidelines for using CLOCK, READY, and 
RWTIMEOUT. 



Table G-l . CLOCK and ENABLE/DISABLE RDY Commands 



User Cable 
Connected 
to: 


User System 


Socket 
Protector 
Assembly 


Logical Memory 
Mapped to: 


User 
Memory 
Only 


Intel 
Memory 
Only 


User and 

Intel 
Memory 


Intel 
Memory 
Only 


CLOCK set 

to: 


EXT 


EXT 
*!NT 


EXT 


INT 


RDY set 
to: 


*ENA 
DIS 


*ENA 
DIS 


*ENA 
DIS 


DIS 



* Recommended 



1 . In standalone mode, ICE-86A is not connected to a user system. CLOCK must 
be set to INTERNAL and the DISABLE RDY mode must be used. 

2. When accessing user memory, CLOCK must be set to EXTERNAL and the 
ENABLE RDY mode should be used. 

3. RWTIMEOUT = 1000 NOERROR is the recommended setting when accessing 
Intellec and disk memory. 
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APPENDIX H 
INSTALLING UPGRADE KIT 



The Upgrade Kit converts an 1CE-86 emulator to an ICE-86A emulator. The follow- 
ing instructions detail procedures for installing the Upgrade Kit for the Intellec 
Model 800 and 888 Systems or the Intellec Series II System. 



Installation Procedure for the Intellec 
Model 800 and 888 Systems 



1. Disconnect the power cords of the Intellec chassis and user system. 

2. Inspect the ICE-86U assemblies for damage. 

3. Remove the top cover of the Intellec chassis. 

4. The ICE-86 circuit boards consist of an FM Controller board, an ICE-86 Trace 
board, and an 86 Controller board. The ICE-86 buffer box is connected by two 
cables to the 86 Controller board and the FM Controller board at terminalson 
the boards marked "X'* and "Y," respectively. Disconnect these cables from 
the circuit boards. 

5. On the side of the ICE-86 buffer box opposite to that which the circuit board 
cables are attached to, there is a "user cable" ending in a forty-prong plug. If 
the user cable is attached to the user's prototype application system, then 
disconnect it. 

6. Also at the end of the user cable is a black plug receptacle. Inserted into this 
receptacle should be the male plug end of the ICE-86 Ground Connector; the 
other end of the Ground Connector should be clipped to system ground. Unclip 
the system ground end of the Ground Connector. 

7. Set aside the ICE-86 buffer box. 

8. Remove the FM Controller board from its chassis slot. 

9. The ICE-86 firmware consists of six PROM's on the FM Controller board at 
locations labeled A2 through A7 on the board. Remove and set aside the ICE-86 
firmware. 

10. The ICE-86A firmware consists of six PROM's labeled A2 through A7. Attach 
these PROM's to the FM Controller board at the locations formerly occupied 
by the ICE-86 firmware, making sure to match the labels on the tops of the 
PROM's with the labels on the board. 

1 1 . Examine the newly-installed firmware to be sure all pins have made contact with 
the FM Controller board. 

12. Re-insert the FM Controller board into the chassis slot it previously occupied. 

13. The ICE-86 Trace board and the 86 Controller board are connected by a "T 
cable"; this cable is attached to the boards at terminals labeled "T." Remove 
the T cable. 

14. Remove the 86 Controller board. 

15. In order to enable External Break, examine the solder side of the 86 Controller 
board for continuity from pin 40 of 12 (the X cable terminal) to pin 5 of RP1 (a 
resistor pack). Continuity exists between the two points if 0 ohms is detected 
between the points or if the 86 Controller board part number is 1001879-03 
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Installing Upgrade Kit 



ICE-86A 



Rev. F or later. If continuity exists, then proceed to instruction #16. If the wire 
is not in place, then the user can make the connection or can contact Intel 
service for assistance. 



WARNING 



The user should avoid applying excessive heat to the 86 Controller 
board while soldering; the traces on the back of the board will- 
detach themselves if exposed to enough heat. A soldering iron with 
a maximum power of 15 to 20 watts is recommended. After solder- 
ing has been completed, the user should check for solder splashes 
that can short parts of the board. The user should also examine the 
wire to be sure good physical contact has been made with the pins. 

16. Re-insert the 86 Controller board into the chassis slot it previously occupied. 

17. Reattach the T cable to the ICE-86 Trace board and the 86 Controller board, 
making sure to mate the blocked inserts on the cable receptacles with the missing 
pins on the board terminals. 

18. The ICE-86 buffer box has a pair of cables coming out of one side contained 
within a rubber zipper tube. At the end of each cable is a 40-pin receptacle; one 
receptacle is marked "X" and one is marked "Y" (corresponding to the circuit 
board cables of the ICE-86 buffer box). Attach the buffer box cable receptacle 
marked "X" to the 86 Controller board terminal marked "X," making sure to 
mate the missing pin on the board terminal with the blocked insert on the cable 
receptacle. 

19. Attach the buffer box cable receptacle marked "Y" to the FM Controller board 
terminal marked "Y," making sure to mate the missing pin on the board ter- 
minal with the blocked insert on the cable receptacle. 

20. If a user prototype application system is to be connected, remove the Socket 
Protector assembly from the user cable of the ICE-86 buffer box and insert the 
40-pin cable terminal into the 8086 socket on the user system. The Socket 
Protector assembly guards the terminal pins from damage and inadvertent 
grounding. 

21. At the end of the ICE-86A buffer box user cable is a black plug receptacle 
corresponding to the one at the end of the ICE-86 buffer box user cable. Insert 
into this receptacle the male plug end of the ICE-86A Ground Connector, and 
clip the other end of the Ground Connector to system ground. 

22. Replace the top cover of the Intellec chassis. 

23. Re-insert the power cords of the Intellec chassis, the Expansion Chassis, and 
user system into their power sources. 



Installation Procedure for the Intellec Series II Systems 

1 . Disconnect the power cords of the Intellec chassis and user system. 
^ 2. Inspect the ICE-86U assemblies for damage. 

^ 3. Remove the front cover of the expansion chassis housing the ICE-86 circuit 
boards. 

^ 4. The ICE-86 circuit boards consist of an FM Controller board, an ICE-86 Trace 
board, and an 86 Controller board. The ICE-86 buffer box is connected by two 
cables to the 86 Controller board and the FM Controller board at terminals on 
the boards marked "X" and "Y," respectively. Disconnect these cables from 
the circuit boards. 
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^5. On the side of the ICE-86 buffer box opposite to that which the circuit board 
cables are attached to, there is a "user cable" ending in a forty-prong plug. If 
the user cable is attached to the user's prototype application system, then 
disconnect it. 

7 6. Also at the end of the user cable is a black plug receptacle. Inserted into this 
receptacle should be the male plug end of the ICE-86 Ground Connector; the 
other end of the Ground Connector should be clipped to system ground. Unclip 
the system ground end of the Ground Connector. 

^7. Set aside the ICE-86 buffer box. 

^8. Remove the FM Controller board from its chassis slot. 

w~ 9. The ICE-86 firmware consists of six PROM's on the FM Controller board at 
locations labeled A2 through A7 on the board. Remove and set aside the ICE-86 
firmware. 

HK). The ICE-86 A firmware consists of six PROM's labeled A2 through A7. Attach 
these PROM's to the FM Controller board at the locations formerly occupied 
by the ICE-86 firmware, making sure to match the labels on the tops of the 
PROM's with the labels on the board. 

^11. Examine the newly-installed firmware to be sure all pins have made contact with 
the FM Controller board. 

2. Re-insert the FM Controller board into the chassis slot it previously occupied. 

— T3. The ICE-86 Trace board and the 86 Controller board are connected by a "T 
cable"; this cable is attached to the boards at terminals labeled "T." Remove 
theT cable. 

14. Remove the 86 Controller board. 

fi5. To enable External Breaks, examine the solder side of the 86 Controller board 
for continuity from pin 40 of 12 (the X cable terminal) to pin 5 of RP1 (a 
resistor pack). Continuity exists between the two points if 0 ohms is detected 
between the points or if the 86 Controller board part number is 1001879-03 
Rev. F or later. If continuity exists, then proceed to instruction #16, If the wire 
is not in place, then the user can make the connection or can contact Intel serv- 
ice for assistance. 



WARNING 



The user should avoid applying excessive heat to the 86 Controller 
board while soldering; the traces on the back of the board will 
detach themselves if exposed to enough heat. A soldering iron with 
a maximum power of 15 to 20 watts is recommended. After solder- 
ing has been completed, the user should check for solder splashes 
that can short parts of the board. The user should also examine the 
wire to be sure good physical contact has been made with the pins. 

^ 16. Re-insert the 86 Controller board into the chassis slot it previously occupied. 

— 17. Reattach the T cable to the ICE-86 Trace board and the 86 Controller board, 
making sure to mate the blocked inserts on the cable receptacles with the missing 
pins on the board terminals. 

^-i8. The ICE-86 buffer box has a pair of cables coming out of one side contained 
within a rubber zipper tube. At the end of each cable is a 40-pin receptacle; one 
receptacle is marked "X" and one is marked "Y" (corresponding to the circuit 
board cables of the ICE-86 buffer box). Attach the buffer box cable receptacle 
marked "X" to the 86 Controller board terminal marked "X," making sure to 
mate the missing pin on the board terminal with the blocked insert on the cable 
receptacle. 
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^19. Attach the buffer box cable receptacle marked "Y" to the FM Controller board 
terminal marked "Y," making sure to mate the missing pin on the board ter- 
minal with the blocked insert on the cable receptacle. 

i^20. If a user prototype application system is to be connected, remove the Socket 
Protector assembly from the user cable of the ICE-86 buffer box and insert the 
40-pin cable terminal into the 8086 socket on the user system. The Socket 
Protector assembly guards the terminal pins from damage and inadvertent 
grounding. 

? 21. At the end of the ICE-86A buffer box user cable is a black plug receptacle 
corresponding to the one at the end of the ICE-86 buffer box user cable. Insert 
into this receptacle the male plug end of the ICE-86A Ground Connector, and 
clip the other end of the Ground Connector to system ground. 

22. Replace the front cover of the expansion chassis housing the ICE-86 circuit 
boards. 

23. Re-insert the power cords of the Intellec chassis, the Expansion Chassis, and 
user system into their power sources. 
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8087 DEBUGGING SUPPORT 



Introduction 

When an 8087 NDP (Numeric Data Processor) shares a system bus with an 8086 
CPU, the arithmetic abilities of the 8086 processor are expanded to include floating 
point calculations. The ICE-86A emulator can be used as a debugging tool for the 
8087 chip or the 8087 software emulator. To debug floating point operations in user 
software, a file of Floating Point MACROS has been added to the ICE-86A system 
disk; the name of the file is 8087.MAC. The details of these MACROS are given 
below. For further information concerning the 8087 NDP in general, the user should 
consult The 8086 Family Users Manual Numerics Supplement, Manual Order 
Number 121586. 

NOTE 

ICE-86A hardware is not equipped to monitor the system bus while another 
device, such as the 8087 NDP, is in control. Therefore, the emulator's 
breakpoint capabilities are not available when it is not the system bus 
master. Hence, ICE-86A support for the 8087 NDP can be best character- 
ized as a software debug aid, rather than, as it is for the 8086 processor, a 
system design tool. 

The MACROS are merely sets of ICE-86A commands like those entered at 
the console. They are intended to be very general and are therefore fairly 
slow in execution. Users may model their own 8087 debugging aids on these 
macros. 



The Floating Point Macros use four ICE variables named: 

.?Z1 .?Z2 .?Z3 .?Z4 

If the user has created any variables with these names, they will conflict 
when running the Floating Point Macros. 

The Status Block 

Almost all of the floating point MACROS access 108-byte blocks of memory termed 
"status blocks." These status blocks contain: 

1 . status and variables used by the MACROS, 

2. code for execution, 

3 . temporary 8086 register values, 

4. 8087 or emulated 8087 register values. 

When using the 8087 chip, status blocks can only be stored in user memory; that is, 
the memory used for those macros must be mapped to user memory. Because of 
8087 control of the system bus, it is impossible to transfer information to Intellec, 
disk, or ICE memory. This does not occur when using the software emulator for the 
8087; since the software is stored in the 8086 CPU, the emulated 8087 
microprocessor has access to the same memory space as the 8086 microprocessor. 

The FLAG byte of a status block (byte 0) indicates whether the 8087 chip or the 8087 
emulator is being used. 



1-1 



8087 Debugging Support 



ICE-86A 



The COMMAND bytes (bytes 1 through 5) are a workspace area where the called 
MACRO writes commands for the controlling device to execute. 

The REGISTER bytes (bytes 6 through 13) are used as a save area for 8086 registers. 
The CS, IP, DS, and DI 8086 registers are temporarily stored in these bytes during 
the execution of the GETBLK and PUTBLK MACROS. These MACROS overwrite 
the 8086 registers as part of their status information transferal procedures. The 8086 
registers are restored after execution has been completed. 

The BLOCK bytes (bytes 14 through 107) contain the actual NDP status informa- 
tion. This information includes the Command, Status, and Tag Words, as well as 
the NDP stack. It also contains the last instruction address, the last operation, and 
the last operand address if the operation referred to an operand. 

See figures 1-1 through 1-7 for illustrations of these formats. 



Floating Point Macro Side Effects 

Most of the floating point MACROS contain a DISABLE EXPANSION Com- 
mand. That is, they suppress the display of MACRO code prior to execution. This is 
done for user convenience. To restore display, use the ENABLE EXPANSION 
Command. (See Chapter 8 for the ENABLE/DISABLE EXPANSION Command.) 

The GETBLK and PUTBLK MACROS temporarily disable TRACE. This is done 
to prevent status block information transferal instructions from being recorded in 
the TRACE registers. Under normal circumstances, the loading and unloading of 
status blocks has no relation to the process being emulated. 



jCAUTION| 

The TRACE facility is enabled following execution of either the GETBLK 
or PUTBLK MACROS regardless of the facility's state prior to the 
MACRO invocation. If the user desires that TRACE be disabled after call- 
ing either of these MACROS, then the user must enter the DISABLE 
TRACE Command (see Chapter 6). 

The GO and Breakpoint registers are also altered. These registers are used in the 
transferal of status block information. 



107 


106 


16 


15 
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13 


12 


11 


10 9 8 


7 


6 


5 


4 3 2 


1 


0 


BLOCK 
BYTES 


REGISTER 
BYTES 


COMMAND 
BYTES 


FLAG 
BYTE 



Figure 1-1 . Status Block 162554-10 
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Figure 1-2. Register Bytes Format 1 62554-1 1 
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INCREASING ADDRESSES OFFSET BY 14 



15 



INSTRUCTION 
POINTER 



OPERAND 
POINTER 



NEXT STACK 
ELEMENT:ST(1) 



TOP STACK 
ELEMENT.ST 



J 



LAST STACK 
ELEMENT:ST(7) 



CONTROL WORD 



STATUS WORD 



TAG WORD 



IP15-0 



IP19-16 



OPCODE 



OP15-0 



OP19-16 



SIGNIFICAND 15-0 



SIGNIFICAND 31-16 



SIGNIFICAND 47-32 



i 



SIGNIFICAND 63-48 



EXPONENT 14-0 



SIGNIFICAND 15-0 



SIGNIFICAND 31-16 



SIGNIFICAND 47-32 



SIGNIFICAND 63-48 



EXPONENT 14-0 



SIGNIFICAND 15-0 



SIGNIFICAND 31-16 



SIGNIFICAND 47-32 



SIGNIFICAND 63-48 



EXPONENT 14-0 



+ 0 
+ 2 
+ 4 
+ 6 
+ 8 
+ 10 
+ 12 
+ 14 
+ 16 
+ 18 
+ 20 
+ 22 
+ 24 
+ 26 
+ 28 
+ 30 
+ 32 

i 

+ 84 
+ 86 
+ 88 
+ 90 
+ 92 



NOTES: 
S = Sign 

Bit 0 of each field is rightmost, least significant bit of corresponding 
register field. 

Bit 63 of significand is integer bit (assumed binary point is immediately 
to the right). 



Figure 1-3. Block Bytes Format 1 62554-1 2 
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15 



IC 


RC 


PC 


IEM 




PM 


UM 


0. 


ZM 


DM J 



l| IM | 



L 



EXCEPTION MASKS (1 = EXCEPTION IS MASKED) 
INVALID OPERATION 
DENORMALIZED OPERAND 
ZERODIVIDE 
OVERFLOW 
UNDERFLOW 

• PRECISION 
(RESERVED) 

• INTER RUPT-EN ABLE MASKd) 

• PRECISION CONTROL^) 

• ROUNDING CONTROL^) 
INFINITY CONTROL* 4 ) 

• (RESERVED) 



< 1 > Interrupt-Enable Mask: 

0 = Interrupts Enabled 

1 = Interrupts Disabled (Masked) 

(2) Precision Control: 

00 = 24 bits 

01 = (reserved) 

10 = 53 bits 

11 =64 bits 

(3) Rounding Control: 

00 = Round to Nearest or Even 

01 = Round Down (toward -°°) 

10 = Round Up (toward +°°) 

11 = Chop (T runcate Toward Zero) 
W Infinity Control: 

0 = Projective 

1 = Aff line 



Figure 1-4. Control Word Format 
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15 



C3 



ST 



C2 



C1 



CO 



IR 



PE 



UE 



OE 



ZE 



DE 



3 



L 



EXCEPTION FLAGS (1 = EXCEPTION HAS OCCURRED) 

INVALID OPERATION 

DENORMALIZED OPERAND 

ZERODIVIDE 

OVERFLOW 

UNDERFLOW 

PRECISION 
(RESERVED) 
INTERRUPT REQUEST 
CONDITION CODEd) 
STACK TOP POINTERS) 
BUSY 



< 1 > See descriptions of compare, test, examine and remainder instructions in section S.7 for 

condition code interpretation. 
(2) ST values: 

000 = register 0 is stack top 

001 = register 1 is stack top 



111= register 7 is stack top 

Figure 1-5 . Status Word Format 



162554-14 
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13 I U 

I TAG(7) TAG (6) TAG(5) TAG(4) I TAG(3) I TAG(2) TAG(1) I TAG(O) I 
I I I I I I I I I I I I I I I I I 



Tag values: 

00 = Valid (Normal or Unnormal) 

01 = Zero (True) 

10 = Special (Not-A-Number, «=, or Denormal) 

11 = Empty 



Figure 1-6. Tag Word Format 162554-15 



OPERAND ADDRESS* 1 > 

| INSTRUCTION OPCODE^) 



INSTRUCTION ADDRESS* 1 ) 



10 0 

< 1 > 20-bit physical address 

< 2 > 1 1 least significant bits of opcode; 5 most significant bits are always 8087 hook (11011 B) 



Figure 1-7. Exception Pointers Format 162554-16 

The Define Block Macro 

SYNTAX :DEFBLK symbol, pointer-address ,ndp 

where ndp = 8087: :87: :87E 

RESULT Defines a status block at a given location in memory to be 

accessed by the MACROS and assigns it a symbolic value. 
"8087" and "87" both refer to the 8087 NDP; "87E" indicates 
the 8087 software emulator. The pointer-address is the beginning 
address of the block (in user memory if using the 8087 chip). 

SIDE EFFECTS None. 

Example: 

".DEFBLK .ONE,0:2000,87 

The Get Block Macro 

SYNTAX :GETBLK symbol 

RESULT Reads the NDP status into the selected status block. 

SIDE EFFECTS MACRO expansion disabled. TRACE temporarily disabled. 8086 
registers temporarily stored in REGISTER bytes. The Go and 
Breakpoint registers are altered. 

Example: 

■.GETBLK .ONE 
*** TRACE now off*** 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:2006H 
*** TRACE now on*** 
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The Put Block Macro 

SYNTAX :PUTBLK symbol 

RESULT Writes the status block to the NDP. 

SIDE EFFECTS MACRO expansion disabled. TRACE temporarily disabled. 8086 
registers temporarily stored in REGISTER bytes. If the 8087 soft- 
ware emulator is executing the MACRO commands, then the Go 
and Breakpoint registers are altered. 

Example: 

:PUTBLK .ONE 
EMULATION BEGUN 

EMULATION TERMINATED, CS:IP=0000:2006H 
*** TRACE now on *** 



The Remove Block Macro 

SYNTAX :REMBLK symbol 

RESULT Releases the 108 bytes in memory associated with the status block 

name and removes the status block name from the symbol table. 

SIDE EFFECTS None. 

Example: 

*:REMBLK .ONE 



The Display Stack Macro 

SYNTAX :STACK symbol 

RESULT Displays NDP stack elements and their associated tags in 

hexadecimal format. 

SIDE EFFECTS MACRO expansion disabled. Display base becomes hexadecimal. 
Example: 



*:STACK.ONE 
























REGISTER 










VALUE 










TAG 




(hi) 














do) 




ST(OOH) 


3FH 


FFH 


80H 


00H 


0 0 H 


00 H 


00H 


00H 


00 H 


00H 


03H 


ST(01H) 


40H 


00H 


80H 


00H 


00H 


0 0 H 


00H 


00H 


00H 


00H 


02H 


ST(02H) 


40H 


00H 


C7H 


DFH 


3BH 


64H 


5AH 


1CH 


ACH 


08 H 


01 H 


ST(03H) 


40H 


OCH 


C0H 


E6H 


B7H 


31 H 


8FH 


C5H 


04H 


81 H 


00H 


ST(04H) 


BFH 


BCH 


BAH 


90 H 


08H 


4AH 


1 5H 


89 H 


EDH 


F0H 


03H 


ST(05H) 


50H 


02H 


A8H 


85H 


04H 


B9H 


03H 


30H 


DBH 


E2H 


02H 


ST(06H) 


40 H 


31 H 


8CH 


4DH 


B7H 


F3H 


40H 


3EH 


40H 


00H 


01 H 


ST(07H) 


40 H 


02H 


80H 


0 0 H 


00 H 


00H 


00H 


0 0 H 


00H 


00H 


00H 
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The Evaluate Stack Macro 

SYNTAX :EV ALSTK symbol 

RESULT Displays NDP stack elements in decimal format and 

disassembled. 

SIDE EFFECTS MACRO expansion disabled. 

Example: 



*:EVALSTK .ONE 






REGISTER 


VALUE 


TAG 


ST(OOH) 


+ 1.00000000000000000E + 0 


FREE 


ST(01H) 


+ 2.00000000000000000E + 0 


NaN/INFINITE/DENORMAL 


ST(02H) 


+ 3.12300000000000000E + 0 


ZERO 


ST(03H) 


+ 1.23456789000000000E + 4 


VALID 


ST(04H) 


- 9.87654321 000000000E-21 


FREE 


ST(05H) 


+ 1 .1 0000000000000000E + 1 234 


NaN/INFINITE/DENORMAL 


ST(06H) 


+ 1 .23412341 2341 23400E + 15 


ZERO 


ST(07H) 


+ 8.00000000000000000E + 0 


VALID 



The Display Status Macro 

SYNTAX :STATUS symbol 

RESULT Displays the Status, Control, and Tag Words, and their 

associated bit maps. It also displays the last instruction address, 
the last operation, and the last operand address 

SIDE EFFECTS MACRO expansion disabled. 

Example: 

* STATUS .ONE 
CONTROL WORD: 

BIT MAP = | x | x | x | AC | RC(2) | PRE(2) | / | M | x | MP | MU | MO | MQ | MD | Ml | 
WOR 000O:200EH=00O0001 01 111111 1Y 

STATUS WORD: 

BIT MAP = | B | Z | TOP(3) |C|A|S|/|N|x|P|U|0|Q|D|l| 
WOR 0000 : 201 0 H =01 000001 00000000 Y 

TAG WORD: 

BIT MAP = | T7(2) | T6(2) | T5(2) | T4(2) | / 1 T3(2) | T2(2) | T1(2) | T0(2) | 
NOTE: Tags are mapped to absolute registers, they are not stack relative 
WOR 0000:201 2H =0001 1 01 10001 1 01 1 Y 

INSTRUCTION ADDRESS: (pseudo base-displacement) 
F000:C9DEH 

LAST OPERATION: {8087 format) 
CDH1CH 

OPERAND ADDRESS: (pseudo base-displacement) 
0C04H 
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The Evaluate Status Macro 

SYNTAX :EVALSTAT symbol 

RESULT Evaluates Control and Status Words and displays information to 

the user. Displayed are the infinity arithmetic, rounding, and 
precision formats, masked bits, the state of the ZERO and BUSY 
flags, the pointer to the top of the NDP stack, the state of error- 
handling flags, and error warning messages for standard types of 
errors. 

SIDE EFFECTS MACRO expansion disabled. 

Example: 

*:EVALSTAT .ONE 
CONTROL WORD: 
CLOSURE = PROJECTIVE 
ROUNDING = NEAREST/EVEN 
DOUBLE PRECISION 
MASK = TRUE 
MASK BITS SET: 

PRECISION ERROR 

UNDERFLOW ERROR 

OVERFLOW ERROR 

DIVIDE BY ZERO ERROR 

DENORMALIZATION ERROR 

INVALID ERROR 
STATUS WORD: 
BUSY = FALSE 
C3(ZERO) = TRUE 
TOP = REGISTER 00H 
C2= FALSE 
C1= FALSE 
C0(SIGN) = 01H 
INTERRUPT = FALSE 
ERROR FLAGS SET: 



The Evaluate Control Word Macro 

SYNTAX :EVALCW symbol 

RESULT Evaluates Control Word and displays information to user. 

Displayed are infinity arithmetic, rounding, and precision for- 
mats, masked bits, and error warning messages for standard types 
of errors. 

SIDE EFFECTS MACRO expansion disabled. 
Example: 

:EVALCW .ONE 
CONTROL WORD: 
CLOSURE = PROJECTIVE 
ROUNDING = NEAREST/EVEN 
DOUBLE PRECISION 
MASK = TRUE 
MASK BITS SET: 

PRECISION ERROR 

UNDERFLOW ERROR 

OVERFLOW ERROR 

DIVIDE BY ZERO ERROR 

DENORMALIZATION ERROR 

INVALID ERROR 
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The Evaluate Status Word Macro 

SYNTAX :EVALSW symbol 

RESULT Evaluates Status Word and displays information to user. 

Displayed are the state of the ZERO and BUSY flags, the pointer 
to the top of the NDP stack, the state of error-handling flags, and 
error warning messages for standard types of errors. 

SIDE EFFECT MACRO expansion disabled. 

Example: 

:EVALSW .ONE 
STATUS WORD: 

BUSY = FALSE 

C3(ZERO)=TRUE 

TOP = REGISTER 00H 

C2 = FALSE 

C1 = FALSE 

C0(SIGN) = 01H 

INTERRUPT = FALSE 

ERROR FLAGS SET: 



The Display or Change Control Word Macro 

SYNTAX :CW symbol [=word-value] 

RESULT Display or change of the Control Word in the current base. If 

:CW symbol is entered, then the value of the Control Word is 
displayed. If :CW symbol, =word value is entered, then display is 
suppressed and the value of the Control Word is changed to 
word-value . 



WARNING 



Bits 6, 13, 14, and 15 of the Control Word are unassigned 
and reserved. The operator should avoid altering the 
value of these bits, as this may lead to an incompatibility 
with the ICE-86A module. 

SIDE EFFECTS None. 

Examples: 

*:CW .ONE,=2FF 
* 

*:CW .ONE 

WOR0000:200EH=02FFH 

The Display or Change Status Word Macro 

SYNTAX :SW symbol [=word-value] 

RESULT Display or change of the Status Word in the current base. If :SW 

symbol is entered, then the value of the Status Word is displayed. 
If :SW symbol ^word-value is entered, then display is suppressed 
and the value of the Status Word is changed to word-value. 
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SIDE EFFECTS None. 
Examples: 

*:SW .ONE =4100 
* 

*:SW .ONE 

WOR 0000: 201 OH =41 00 H 



The Display or Change Tag Word Macro 

SYNTAX :TW symbol [=word-value] 

RESULT Display or change of the Tag Word in the current base, if :TW 

symbol is entered, then the value of the Tag Word is displayed. If 
:SW symbol , -word-value is entered, then display is suppressed 
and the value of the Tag Word is changed to word-value. 

SIDE EFFECTS None. 

Examples: 

*:TW .ONE =1B1B 

*:TW.ONE 

WOR 0000:201 2H=1B1BH 



The Display or Change Stack Macro 

SYNTAX :STK symbol .offset [=real-value] 

where offset is an integer from 0 to 7 representing the distance of 
an element from the top of the NDP stack. 

RESULT Display or change of individual NDP stack elements in decimal 

format. If :STK symbol .offset is entered, then the offset-th of the 
stack is displayed. If :STK symbol .offset ^real-value is entered, 
then display is suppressed and the value of the offset-th element 
of the stack is changed to real-value . 

SIDE EFFECTS MACRO expansion disabled. 

Examples: 

*:STK.ONE,0 =1.0 

*:STK .ONE,7 =8. 
* 

*:STK.ONE,0 

TRE 0000:201 CH= + 1 .00000000000000000E + 0 
*:STK.ONE,7 

TRE 0000:2062H= + 8.00000000000000000E 4- 0 
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The Display Stack Address Macro 

SYNTAX :STKADDR symbol ,off set 

where offset is an integer from 0 to 7 representing the distance of 
an element from the top of the NDP stack. 

RESULT Displays the memory location of a particular NDP stack element 

so that the user may access the individual bytes of the stack. The 
display occurs in all four bases — binary, octal, decimal, and 
hexadecimal — and also includes the corresponding ASCII 
characters. (The STKADDR MACRO is based on the 
EVALUATE command; see Chapter 7 for details.) The hexa- 
decimal value refers to the lowest byte in logical memory where 
the stack element is stored; the stack element is contained in ten 
consecutive bytes, starting at the byte listed. (In the example given 
below, for instance, "201CH" means that the stack element is 
stored in bytes 201CH through 2025H in logical memory.) 

SIDE EFFECTS MACRO EXPANSION disabled. 

Example: 

* -.STKADDR .ONE,0 

1 000000001 1100Y 20034Q 8220T 201 CH ' ' 
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The following is a listing of the Floating Point Macros with comments. It is con- 
tained in the file 8087.HLP on the ICE-86A diskette. 



:8087 SUPPORT MACROS C INTEL 1981 

5 

. ************************************ 

; DEFINE LOCAL SYMBOLS (VARIABLES) 
> 

DEFINE .?Z1=0 
DEFINE .'?Z2-0 
DEFINE .?Z3=0 
DEFINE . ?Z4 = 0 
» 

************************************************ 
5 

DEFINE MACRO DEFBLK 
DISABLE EXPANSION 

IF (OFFSET (%1) + 108T) < OFFSET (%1) THEN 

; THE OFFSET SELECTED MUST BE ABLE TO REACH THE 108 BYTES OF THE DATA BLOCK 

WRITE ' OFFSET VALUE TOO HIGH - TRY AGAIN' 

ELSE 

DEFINE %0 - %1 ; SYMBOL GETS ADDRESS VALUE 

IF %2H = 8087H THEN 

BYTE %1=0FFH ; TRUE FOR 8087 

ORIF %2H «' 87H THEN 

BYTE %1 = OFFH ;87 -« 8087 

ELSE 

BYTE XI - 0 ; FALSE FOR 87 EMULATOR 

ENDIF 

ENDIF 

EM 

* 

********************************************* 

DEFINE MACRO GETBLK 

DISABLE EXPANSION ; DISABLE THE MACRO EXPANSION 

DISABLE TRACE ;DON'T TRACE THE FLOATING POINT EXECUTION 

WRITE '*** TRACE now off ***' 

WORD %0+6T - CS ;SAVE CURRENT EXECUTION LOCATION 

WORD %0+8T = IP 

WORD %0+10T - DS ;SAVE POINTERS 

WORD %0+12T - DI 

DS = SEGMENT ( %0 ) ; SEGMENT ADDRESS OF USER-DEFINED BLOCK 

DI - OFFSET(%0+14T) ;SET OFFSET TO BEGINNING OF 8087 EXTERNAL REGISTER AREA 
IF (BYTE %0) THEN ; IF 8087 THEN... 

BYTE %0+l - 9BH,DDH,35H,9BH,F4H ;WAIT, SAVE ALL OF 8087 REGISTERS, WAIT, HALT 
GO FROM %0+l TILL HALT ; WAI T , EXECUTE THE F S AVE , WAIT, AND HALT 

ELSE ;IF 87 EM THEN. . . 

BYTE %0+l - CDH,1DH,35H,F4H ; GET ALL STATUS FROM 87EM 

GO FROM %0+l TILL HALT 

WRITE '*** GR and BR registers altered ***' 
ENDIF 

CS - (WORD %0+6T) ; RESTORE 8086 REGISTERS 

IP = (WORD %0+8T) 

DS - (WORD %0+10T) 

DI = (WORD %0+12T) 

ENABLE TRACE ; AND TRACE 

WRITE '*** TRACE nov; on ***' 

EM 

5 

**************************************** 
> 

DEFINE MACRO PUTBLK 

DISABLE EXPANSION ; D IS ABLE MACRO EXPANSION 

DISABLE TRACE ; DON'T TRACE THE FLOATING POI*JT EXECUTION 
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WORD %0+6T * CS ;SAVE CURRENT EXECUTION LOCATION 

WORD %0+8T - IP 

WORD %0+10T = DS ;SAVE DATA SEGMENT AN OFFSET POINTERS 

WORD %0+12T - DI 

DS = SEGMENT ( %0 ) ; SEGMENT ADDESS OF USER-DEFINED BLOCK 

DI = OFFSET(%0+14T) ; POINT TO DATA AREA HOLDING ALL OF 8087 ENVIRONMENT 

IF (BYTE %0) THEN ;IF 8087 THEN... 

BYTE %0+l - 9BH,DDH,25H,9BH,F4H ;WAIT, RESTORE 8087 ENVIRONMENT, WAIT, HALT 
GO FROM %0+l TILL HALT ;WAIT, EXECUTE THE FRSTOR, WAIT, AND HALT 
ELSE ; IF 87 EM THEN. . . 

BYTE %0+l = CDH,1DH,25H,F4H ; RE STORE STATUS TO 87EM 

GO FROM %0+l TILL HALT 

WRITE '*** GR and BR registers altered ***' 
ENDIF 

CS - (WORD %0+6T) ; RESTORE 8086 REGISTERS 

IP - (WORD %0+8T) 
DS - (WORD %0+10T) 
DI - (WORD %0+12T) 

ENABLE TRACE ; AND TRACE 

WRITE '*** TRACE now on ***' 

EM 

**************************************** 

DEFINE MACRO REMBLK 

REMOVE %0 ; REMOVE BLOCK FROM SYMBOL TABLE 

EM 

**************************************** 
DEFINE MACRO STATUS 

; DISPLAY THE STATUS WORD, CONTROL WORD, TAG WORD, AND THE LAST INSTRUCTION 
; ADDRESS, OPCODE, AND OPERAND TYPE. 
DISABLE EXPANSION 
BASE = Y 

WRITE 'CONTROL WORD: ' 

WRITE ' BIT MAP - | x | x | x | AC | RC ( 2 ) | PRE ( 2 ) | / | M | x | MP | MU | MO | MQ | MD | MI |' 
: CW %0 
WRITE ' ' 

WRITE 'STATUS WORD:' 

WRITE ' BIT MAP - | B | Z | TOP ( 3 ) | C | A | S | / | N | x | P | U I 0 | Q | D | I| ' 

:SW %0 

WRITE ' ' 

WRITE 'TAG WORD: ' 

WRITE ' BIT MAP = | T 7 ( 2 ) 1 T6 ( 2 ) | T 5 ( 2 ) | T4 ( 2 ) | / | T 3 ( 2 ) | T 2 ( 2 ) | T 1 ( 2 ) | TO ( 2 ) |' 

WRITE ' NOTE: Tags are mapped to absolute registers, they are not stack relative ' 

:TW %0 

BASE - H 

WRITE ' ' 

WRITE ' ' 

WRITE 'INSTRUCTION ADDRESS: (pseudo base-displacement)' 

WRITE (((BYTE %0+2 3T ) / 1 6T*4K) : ( WORD %0+20T)) ; GET UPPER 4 BITS OF 20 BIT 
; ADDRESS , MAKE IT INTO A SEGMENT VALUE. PRINT THE LOWER 16 BITS AS OFFSET. 
WRITE ' ' 

WRITE 'LAST OPERATION: (8087 format)' 

WRITE C8H+( (BYTE %0+23T) AND 07H ) , ' ' , BYTE %0+22T 

WRITE ' ' 

WRITE 'OPERAND ADDRESS: (pseudo base-displacement)' 

WRI (((BYTE %0+27T)/16T*4K):(WORD %0+24T)) 

EM 

**************************************** 

DEFINE MACRO STACK 
DISABLE EXPANSION 
BASE = H 

WRITE 'REGISTER VALUE TAG' 
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WRITE ' (hi) — — (lo) 

. ?Z1 - 0 ;USED FOR PASSING VALUE TO MACRO TAG AND FOR LOCAL COUNTER 

COUNT 8T ;8 - 80 BIT STACK REGISTERS IN 8087 

: TAG Z0,(»?ZI) ;PASSES BACK .?Z4 
• ?Z2 = .?Z1*10T 

'.BYTE %0+. 7Z2+37T, ' '> & 
' , BYTE Z0+. 7Z2+35T, ' ',& 
' f BYTE Z0+. ?Z2+33T, ' 
' , BYTE %0+. ?Z2+31T, ' 
* , BYTE Z0+. ?Z2 + 29T, ' 
' , . ?Z4 



WRITE 'ST( ' , • ?Z1 , ' ) 

BYTE %0+.?Z2+36T, 

BYTE %0+. 7Z2+34T, ' 

BYTE %0+. ?Z2+32T, ' 

BYTE Z0+.7Z-2+30T,.* 

BYTE %0+. ?Z2 + 28T, ' 

. ?Z1 = . ?Z1 + 1 

END 

EM 



**************************************** 



DEFINE MACRO EVALSTK 
DISABLE EXPANSION 

WRITE 'REGISTER VALUE TAG' 

WRITE ' ' 

,?Z1 = 0 ;USED FOR PASSING VALUE TO MACRO TAG AND FOR LOCAL COUNTER 

COUNT 8T ;ONCE FOR EACH STACK ELEMENT 

: TAG %0,.?Z1 ;PASSES BACK .?Z4 



.?Z2 - (%0+( • ?Z1*10T)+28T) 



IF .?Z4 = 0 THEN 
WRITE 'ST( ' , . ?Z1 , ' ) 
?Z4 = 1 THEN 
'ST(',.?Z1,') 
?Z4 = 2T THEN 
'ST( ' , • ?Z1 , ' ) 
?Z4 = 3T THEN 
' ST( ' , . ?Z1 , ' ) 



; TEST TAG 
' , TREAL 

' 9 TREAL 

' , TREAL 



. ?Z2 , 
> ?Z2 , 
,?Z2, 



OR IF 
WRITE 
ORIF 
WRITE 
ORIF 
WRITE 
END IF 
. ?Z1 
END 
EM 



**************************************** 



VALID' 
ZERO ' 

NaN / INFINITE /DENORMAL' 
FREE' 



,?Z1 + 1 



, TREAL .?Z2,' 
; ALL POSSIBLE TAG VALUES COVERED 



DEFINE MACRO EVALSTAT 
DISABLE EXPANSION 
:EVALCW %0 
:EVALSW %0 
EM 

************************************************************************** 



DEFINE MACRO EVALCW 

DISABLE EXPANSION 

WRITE 'CONTROL WORD:' 

IF ( (WORD %0+14T)/4K) THEN 



WRITE ' 
ELSE 
WRITE ' 
END IF 
. ?Z1 - 
IF .?Z1 
WRITE ' 
ORIF 
WRITE 
ORIF 
WRITE 
ORIF 
WRITE 
END IF 
• ?Z1 



CLOSURE = AFFINE ' 

CLOSURE = PROJECTIVE' 

(((WORD %0+14T)/lK) AND 03H) 
- 0 THEN 
' ROUNDING = NEAREST/EVEN' 
?Z1 = 1 THEN 
' ROUNDING 
?Z1 = 2 THEN 
' ROUNDING 
-?Z1 = 3 THEN 
' ROUNDING 



DOWN ' 



UP' 



TRUNCATE ' 



(((WORD %0+l4T)/256T) AND 03H) 
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IF . 7Z1 - 0 THEN 

WRITE ' SINGLE PRECISION ' 

ORIF . ?Z1 = 2 THEN 

WRITE ' DOUBLE PRECISION' 

ORIF .7Z1 - 3 THEN 

WRITE ' TEMPORARY PRECISION' 

END IF 

WRITE ' MASK - ',BOOL((WORD % 0+ 1 4T ) / 1 2 8T ) 

WRITE ' MASK BITS SET:' 

. ?Z1 = (WORD %0+14T) 

IF .?Z1/32T THEN 

WRITE ' PRECISION ERROR' 

END IF 

IF .TZ1/16T THEN 

WRITE ' UNDERFLOW ERROR' 

END I F 

IF .?Z1/8T THEN 

WRITE ' OVERFLOW ERROR' 

END IF 

IF .7Z1/4T THEN 

WRITE ' DIVIDE BY ZERO ERROR' 

END IF 

IF .7Z1/2T THEN 

WRITE ' DENORMALIZ AT I ON ERROR' 

ENDIF 

IF .?Z1 THEN 

WRITE * INVALID ERROR' 

ENDIF 

EM 

;****** 

DEFINE MACRO EVALSW 

DISABLE EXPANSION 

WRITE 'STATUS WORD: ' 

. 7Z1 = (WORD %0+16T) 

WRITE ' BUSY = ' ,BOOL( . ?Z1 /32K) 

WRITE ' CO(ZERO) = ' , BOOL ( •7Z1/16K) ;CONDITION CODE BIT 14 

WRITE ' TOP = REGISTER ',(.?Z1/2K) AND 07H 

WRITE ' C2 - ' , BOOL (•TZl/lK) ;CONDITION CODE BIT 10 

WRITE ' CI = ' ,BOOL( . 7Z1 /512T) ;CONDITION CODE BIT 9 

WRITE ' CO(SIGN) = ' , ( . ? Z 1 / 2 5 6T ) AND 01H ;CONDITION CODE BIT 8 

WRITE ' INTERRUPT = ' , BOOL ( . ? Z 1 / 1 2 8T ) 

WRITE ' ERROR FLAGS SET: 

IF ( . 7Z1/32T) THEN 

WRITE ' PRECISION ERROR' 

ENDIF 

IF (.7Z1/16T) THEN 

WRITE ' UNDERFLOW ERROR' 

ENDIF 

IF (.?Z1/8T) THEN 

WRITE ' OVERFLOW ERROR' 

ENDIF 

IF (.7Z1/4T) THEN 

WRITE ' DIVIDE BY ZERO ERROR' 

ENDIF 

IF (.7Z1/2T) THEN 

WRITE ' 0 E NORMAL I Z ATI ON ERROR' 

ENDIF 

IF ( . 7Z1 ) THEN 

WRITE ' INVALID ERROR' 

END 

EM 

DEFINE MACRO CW 
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WORD (%0+14T) %1 
EM 

DEFINE MACRO SW 
WORD (%0+16T) %1 
EM 

;**************************************** 

DEFINE MACRO TW 
WORD (%0+18T) %1 
EM 

DEFINE MACRO STK 
DISABLE EXPANSION 
TRE (%0+28T+%l*10T) %2 
EM 

***************************************** 

DEFINE MACRO STKADDR 
DISABLE EXPANSION 
IF %1 > 7T THEN 

WRITE 'STACK OFFSET TOO LARGE' 
ELSE 

EVALUATE % 0+2 8T+% 1 * 1 OT 

END IF 

EM 

9 

*********************************************** 

DEFINE MACRO TAG ; TAG IS USED INTERNALLY 

.?Z3 - 1 

COUNT ((((WORD %0+16T)/2K) AND 07H)+%1) MOD 8T 

.?Z3 = (.?Z3)*4T 

END 

.?Z4 = ((WORD %0+18T)/(.?Z3)) AND 0311 

; IT IS REQUIRED BECAUSE THE TAG WORD IS NOT IN THE SAME ORDER (STACK 

; RELATIVE) AS THE STACK REGISTER FILE. IT PLACES THE SELECTED TAG INTO 

; BYTE 5 OF THE STATUS BLOCK . THE TAG IS COMPUTED THUS: 

; TOP <- (status_word/2K) AND 0711 

; INDEX <- (TOP + of f set_select) MOD 8 

; TAG <- (tag_word/(4**INDEX) ) AND 03H 

EM 

> 

********************************************* 
> 
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APPENDIX J 
REFERENCE SCHEMATICS 



This appendix contains the following schematic drawings, for user reference: 



TITLE NUMBER 

86 Controller Schematic ( 1 2 sheets) 1 624 1 1 

FM Controller Schematic (8 sheets) 1 624 1 6 

ICE 86/88 Trace Schematic (10 sheets) 162485 

Buffer Board 1 Schematic (8 sheets) 123022 

Buffer Board 2 Schematic (8 sheets) 1 23025 



NOTE 

The documents in this appendix are for general reference only. 
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15 












































14 










































5 
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- BHE.-A 

- ADCD-A 



- AD3-A 

- AD4-A 



- AD7-A 

- ADfl-A 

- ADS-A 

- ADIO-A 



ZZCa,5ZDB,CcZDa 
ZZCa,3ZDS,CZDa 
ZZCS.^ZDa^ZDO 
ZZCB ,5ZDa,GZDB 



^ZDa^ica^iDs 
zzDo.^zca^zDa 

ZZDe.SZCB.&ZDB 
ZZDB.SZCB^ZDB 



zzdb, Bzca.&zca 

ZZDB,5ZCB, &ZCB 
ZZDB.5ZCB, G.ZCB 
ZZDB , BZCB , GiZCS 



■ ADIZ-A 

- ADI3-A 

- ADI4-A 



ZZDB,3ZCS,(i.ZAa 
ZZDa,5ZCS,6>ZAB 
ZZDB,BZCB,CoZAB 
ZZDB,BZBB,CZAB 



BHE-T IfflZCa 
ADGD-T ICDZDB 
ADI-T IfflZDB 
ADZ-T ICDZDB 
AD3-T ICOZDB 
AD4-T IfflZDa 
ADB-T IfflZDB 
ADCa-T ICDZDB 
AD7-T IfflZDB 
ADB-T IfflZDB 
ADS -T IfflZDB 
ADIGD-T IffiZCB 
ADII-T IffiZCB 
ADIZ-T IffiZCB 
ADI3-T IffiZCB 
ADI4-T IffiZCB 





7432 


14 




1 


A47 


7+1 74 


1 6. 


V<i 


s" 


A44-46.9S.99 


'74L374 


za 


20) 




Alt Z0,n,7B,tfi-'JS 


74L$3i>7 


16, 


l£> 


a 


Ai-10 


74L$Z5e 


I Co 


It 


a 


a*>, 35,55 




Ifc 


Ife 


a 




74L<,tt8 


Ifo 


Ifc 


a 


AI5 


74 103 


It, 


)£> 


a 


A^4& 4 100 


"74574 


14 




7 


All 


74$4<Z> 


. 14 


14 


7 


Atfl 


74^37 


1 4 


14 


7 




74S32 


14 


14 


7 


ta\ 


74S30 


1 4 


14 


7 


A2.22. 


74L$Z7 


1 4 


14 


7 




74S&8 


1 4 


14 


7 




74S04 


1 4 


14 


7 


A"I4 


74*pfflZ 


14 




7 


A7| 


745151 


Ifc 


\(v 






3101 


IE. 


16 


B 




ZI47 


18 


IB 


3 


AZ5,Zk 


2I2B 


Ife 


It, 
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21 15 


1 fc 
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ft 


EEF. DE^ 
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T-&T-A.L 
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+ 3V 
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Z. ALL CAPACITAMCE VALUES ARE IW UF..IOODV , ZO°7.. 
I. ALL RE^>IS7AWCE VALUES ARE IK OHMS, *57o , 1/4 W. 
WOTES: UMLEB5 OTHERWISE SPECIFIED 



LAST U5ED 
-RLT-S 




162554-43 



ZB^> 


ADI4 


-A 


ze>?> 


ADI3 




ZB^ 


AD 1 Z. 


- A 


ZB3 


ADI 1 - 


A 


IZC3 


ADI® 


-A 


izca 


AD1- 


A 


zc^> 


ADO 


A 


ZC2> 


AD7- 


A 


ZC^> 


AD(i>- 


A 


ZC5, 


AD*i) - 


A 


ZD5 


AD4- 


A 


ZD3 


AD3 


A 


ZDB 


AD 2. 


A 


ZD3i 


ADI - 


A 


Z.D - ?) 




-A 


ZD3 


BHE 


-A 


TEMADDeCT 



C5I 4Z.CS,5ZDO>ZCa 




1ZAI RDMEMI 



w»i:NONt| » 






14 foi 



162554-44 



J7ZBZ 



«=1ZDI 

SZDI 
SZDI 



=1ZCI 

qzci 

SZCI 
SZCI 



CLK.MUX - 
ILDMUX - 



DH4A - 
DM-SA 

DH7A • 

ADt«i-T 
A U»-T 
A H-T 
A ifc-T 

DM© 

DM I 

DMZ. 

DM3 

JLL. 
a i<a-T ^ 

QBO-T _ 
QB l-T 3Z 
QB2-T 



7ZC2 BEGTRACE • 






_L 



Mil 7 I 

Mjie-. 



- ADI^-A 

- O ftffj A 

- NftVA 

- QB2-A 



- 51TA 

- BE6TRA ■ 



4ZUe, e J ZbG,4,ZAC 



4ZDa, c iZe,&,WAft 

4ZDG 
4ZD6 
4ZD6 



41D6 , jZA6 
4ZDS, ^ZA6 
4ZD8, !)ZA6 
A 4ZDS 



- TADDE-A 4ZDB,?>ZAa 

- T DAT A -A 4ZDS,^ZAa 

- Q5(Z) : A 4ZD6 

- G)SI- A 4Z.De 



ADI^-T KDZCa 
ADIG-T IOZC6 
ADI7-T IfflZCS 

ADia-T tazca 

ADIS-T IO)ZCa 

so -t ifflzca 
si -t icDzce 
sI-t icazca 

TADDR -l 7ZBO 
TDAT A-t 7ZBO 
QSO-T 7ZBe 
QST-T 7ZB6 



w»*NONE|« 








Mir 3 or |D 


A 





162554-45 




162554-46 



<=1ZCI 
HZCI 
SZCI 
^ZCI 



DM3 
DM2 
DM I 
DM(Z> 



IZDB BHE-A- 
IZD3 ADffi-A- 
IZD3 ADI-A - 
IZD3 A DZ- A - 
ZZCI g^l - 
TZCI WRAMffl - 



IZD3 AD5-A- 

iZDB AD4-A- 

IZC3 ADB - A - 

IZCB AD6.-A- 

ZZCI - 



IZC3 
IZCB 
IZC3 
IZC3 

9ZBI 



AD7-A - 
ADS-A- 
AD^-A - 
ADIffl-A- 

WRAMI - 



IZB5 ADII-A - 

IZBB ADIZ-A- 

IZB3 ADI3.-A- 

SZBI WCAMZ. - 

IZB3 ADI4-A - 

3ZDZ ADIS-A- 

3ZDZ ADIC-A- 

3ZDS ADI7- A - 



BZDZ ADIS-A- 
3ZCZ ADR- A — 



^ZBI WPAMs - 



«=1ZBI WCAM4 — 



BZBZ TADDE- A — 
3ZBZ TDATA-A- 



«=1ZBI WEAM5 - 



.ooiufJ. 



P 1 



Dl 
A® 



CS 
WE 



C<5 
WL 



0| = 

ot>^ 

0 3 > 
04 



— S>EE ^HEET DUE 



-MH3HI 6>ZDS,7ZCS 
-MH4HI fcIAB,7ZC6 



-MH0>£ 6>ZCa 

-mhiz: tzaa 



kZDa,7ZCa 
H4H2 kZAa,7ZCe 



-MHCD2) ^zoa 
CoZBa 



tc*fcNONE|« 


turr 






KV 


XET^OF D 


14 


:oi 


A 



162554-47 






EDMHI — 


SZAZ 


MHCDB — 


5ZDZ. 


MH3HI — 


5ZB2 


MH!)Ht — 


SZBI 


wwmh — 


^ZBI 


WRAM& — 


IZDB 


BHE-A — 


IZDB 


ADO- A — 


IZD^ 


AD 1 - A — 


IZDB 


AD2-A — 


IZDB 


ADB-A — 


IZDB 


AD4-A- 


izcb 


ADB-A — 


IZCB 


AD&-A — 


IZCB 


AD7- A — 


IZCB 


ADS- A — 


IZCB 


AD^-A — 


IZCB 


ADIffl-A — 




DMCD — 


Z.ZC 


i C5i - 



■dZCZ MHCBZ- 



92CI 1NSWHO- 
qZBI WEAMICD - 



BZCZ 



MHIZ 



«1ZBI WRAMII - 

BZAZ MHI3 - 

«=1ZBI Wf?AMS - 
^ZBI 



IZBB 
IZBB 
IZBB 
IZBB 
BZDZ 
BZDZ 
BZDZ 
BZDZ 
BZCZ 



ADII-A - 
ADIZ-A- 
ADIB-A- 
ADI4-A - 
ADIB-A- 
ADIC-A- 
ADI7-A- 
ADIS-A — 
ADII-A — 



BZDZ MM4HI - 
BZBZ MH4HZ - 
«1ZAl R.DMHZ. - 



k 



WE. 

DIN 
CS 


WE 


A© 

Ai 




AZ AZS 
Aa ZIZ5AI 


AZC 
ZIZ5AL 


A+ 
A5 
Afc 
A 7 
A8 
A3 




DOUT 


DOUT 



I© 1 



D 4 
■cjWE. 

CS 



A-AA/V—fi 



IX |, 74L' 



— 1,741.5 



74^7 



A2ffi 
74LS^>6>7 1 1 



A?JZ> ^ 



A£(7> ^ , , 




-SEE 5HEET OML 



DC7>-1 qZDO 

Ul-L IZDS 

I'/ 

- |^ 4 I WATC HQ) - L 



- DP-L =IZDa 

- DB-L^ZDS 

- D4-L qiDS 
-DS-U^ZDa 



PZ 



- \^>C,\ MATCHI-L 
D7-L HZDfl 



f^j D |4 toi| 162485 



162554-48 




SZDI IEUTRA- 



ENTKA.CE-L [iE]- 



| — v\X — | 



<RPI <RPl 



•^ZDI IDISMHB4- 



5ZDZ MH3H I - 
"dZBZ - 



~74^©a 

i|gri)Li_ 



+ + "5 V 



<RZDI IDI5TRA- 



SZDZ. MH4MI • 
BZB2 MM4HS • 



HZAI ICLRSTPTR- 
SZD3 WETE - 



^RPl <£RPI <RPI <Rf 



3ZAZ QSffl-T- 
3ZA2. QSI -T - 
3ZAZ TADDg -L- 
3ZAZ TDATA-L- 



k R4 
539® 



a(p clk -t {53}- 



I0ZBZ ADDCLK- 
IO-Z.DTL KWMAIT 



1"" 



IF 



74-pffia 



: * 14 la- 







41^- 



^LlC 74V7, 

rih 



^ 4-j AI2 







OfT 








SEE SHEET OUE 









-MATCHB SZAa 

- EWADDieCT szca 

- BEQTeACE 3zca,azAs 



-MATCH4 aZAS 



- e. mm act az.Da 



-CLKMUX IZD7, BZDajfflZAB 



—Fa] a&cuc-L 



•wit NONE 




0€W 




«MttT7 * 


D 


i4 





162554-49 




162554-50 



ZZAI^ZAI.fcZCI, 
ZZAI^ZAI.fcZCI 
Z.ZAI,4ZAI,CoZCI 
ZZAI.AZAI.feZCI 
ZZAI,4ZAI,<i,ZB! 
ZZAI,4ZAI,<i>ZB 
ZZAI^ZAI.&ZBI, 
ZZBI^ZBI.fcZBI 



SZCZ.KDZCZ Dffl-L - 

,eZCZ,lffiZCZ Dl-L- 

.BZBZVffiZCZ DZ-L - 

,aZBZ,l(2)ZCZ D3-L - 

I.SZBZ.IOZCZ D4-L- 

l,SZBZ,ICZ)ZC2 DS-L - 

SZBZ.IffiZCZ DCo-L ■ 

,aZBZ ; l(2)ZC2 D7-L - 





PI 




51 


Dl-L 


5Z 


OZ-l 


53 


D3-L 


54 


D4-L 


55 


D5-L 


5G 


Dfc-l 


57 


Dl-L 


5S 



7ZCZ EWADDRCT- 





5ELXNT-L UoH 



A£-L [4S> - 



5ELED-L [Zt] - 




A75 
74 < p0>4 



74L$I3B Y4>I- 
<j&ZA Y5 3^ 
G.ZB Y& >| 



Y7_ 



Y7 



A&ffl ' 
7415138 1 
■C|G2A -i 
G2B> > 



A40 ' 
741$I3B 1 
d&2A Y5t>^ 



■ScGZB 



• CLK 
OUT 

CONTROL 



>CLkC 
OUT 

CONTROL 









OfT 








5EE 5HLET OWE 









- DMfflA IZD7,aZC6 
-DHIA IZD7,SZCa 

- DHZ.A izD7,azca 

- DH3A IZD7, SZCS 

- DH4A IZD7,3ZDe,aZC& 

- DH5A izd7, 3ZDa,azca 

- DH£o A IZC7, 5ZDa,SZC& 

- DM7 A I ZC7, 3ZDB,aZCa 
- IDI5TR A 7ZCB 

- TEKJTRA 7ZDQ 

- IDISMH3 4 7ZDB 
-ILDMACT BZDB 
-INSMHO 6ZB8 

- I EMADDRCT ZZC& 

- ISELCLK l<2 ZA V - 

- ILDMUX IZDZ ,3>ZDa 



-dmo) izc7,3Zca,5ZDa/-zca azD& 

DM I IZC7,3ZCB,5ZDa ) aZ.L)ft 

DM2. lZC7,5ZC6,5ZDa,e»ZDa 

^— DM3 IZC7 ) 5ZC6,5ZDS 



- WEAMG D 5ZD6 

- WRAMI 5ZCS 
- WRAMg 5ZBB 
-WRAM3 5ZB6 

- WRAM4 'ziZAS 
-WRAM5 5ZA6 

- WPAM6. tZDft 
-WRAM7 fcZDS 



-WfAMS WBB 

- WgAMIffi 6>Z BB 

- WIS AM I I kZBB 



IfflZD' 



- jgDADffl IfflZDB 

- RDADI KDZCa 

- RDAD2. IffiZCa 



- TCL-RSTP T.R 7ZBS 

- ICLKOVF SZDO 



- gDMLMI 2ZBS 

- eDMEM Z. 4ZbB 

- RDMA-I 
- RDMAZ 

- gDMHI 



flZAB 
BIAS 
6>ZDS 

^ZAa 



L M8fifDAT IC7.B8 


K*Lt:N0MEj "= 


OtPT 




162485 ; 


MV 




SHEET q Of 1 D 
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A. 



S3 
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a 



162554-51 



o 

w 
i 

00 
ON 

> 



<SZBI \WTC.Tl_5 - 



iZB^> 

IZB3 
IZB3 
IZBB 
IZB*> 
IZBB 
IZBB 



AD(2)-T- 

adi-t - 

AD2-T- 
AD5-T- 
AD4-T- 

ads-t- 

ADfii-T- 
AD7-T- 



1ZBI (2 DAD© 



IZA^, 
IZAB 
IZA-i 
IZAB 



Ana-T- 

ADS-T- 
ADKD-T- 
ADII-T- 
IZA^ AD12-T- 
IZAB ADIB-T- 
IZA^, ADI4-T- 
3ZB2 ADI^ -T— 
=1ZA1 ED A D I - 



BZB2 ADI&-T- 
3ZB2 ADll-T- 
5ZB2 ADia-T- 
3ZBZ ADI^-T- 
IZBB BHE.-T- 
3ZB2 Sffl-T- 
3ZBE ^T-T_ 
3ZA 2 5 gT_ 
1ZAI RDAD2 - 
AlT^T 



^Z-AB. 1.H8&DA7- 



'ZJ5Z CLK MUX 



T6TCLK, 
SSZtt ISELCLIC - 



4D 


4Q 


ZD 


2Q 


7D 


70 


OD 


BQ 


3D 


-5Q 


ID 


IQ 


SD 


5Q 






OUT CONTROL 


'CLK. 




4D 


4Q 


ED 


2Q 


7D 


7Q 


BD 


sq 


3>D 


3Q 


ID 


IQ 


5D 


5Q 






OUT CONTROL 


>CLK 





bEE SHEET OWE 



TP.t.-.=M J* IB* 
7ZAe» 



- nz-i 

- D'i-L 

- D4-L 



, "74SB2 

i£>s 







Dl 




D2 


All 




74<5l5l 


D4- 




D5 








DT 




B 




C 









14 





162485 
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162554-52 



m:::nri — i 

JZ 

+-5V j 2^132 |34| — <' 

+ <5V | IQ|ia|2lU3j2SV - 

+ 5V |2^|24|Zfc|26l - 
M 

+5v HeT — 



TPI TPIfa TPI7 TP32 

! f f f 



GNO | I ho|3<?| - 
J3 

(2ND | I | 5 | 5 j8 |I3|34|38|40H 



+ I C<1,I9 



f 0.1,52 

Uso*- 



; Cl,2,4-8,1l-1<b, 20,2; 
0.01 ,5<2>V 





3 


5 


7 


8 


9 


U 


\3 


14 


15 


n 


19 


21 


22 


23 


26 


Z<0 


27 


29 


30 


31 


33 


35 


4 I 






42 


43 


45 


47 


48 


49 
















J7 


\ 






7 




11 


12 


13 


\=> 


n 


19 


21 


22 


25 


2=5 


2fc 


11 


21 


31 


33 


35 


37 


31 


40 




41 


43 


45 




GVS5[4j- 



"1 « 



MOTE 5 : ^NIE<=)S OTERWISE SPEFIRED 

\, CAPACITANCE' VALUER ARE IN MICROFARADS \0%,1<5V. 
2. RESISTANCE VALUE'S ARE >M OHMS 5% f /4-#- 



SPA RES 


TYPE 


REF. DES. 




IK RES. PACK 


RPI0,I2 


5 


TEST POINTS 


TP 18 - 24 


7 


me 


U30 


3 


1400 


U25 




74L574A 






743 2 


U21 


1 


74309 


U20 


Z 


5.&K RES. RACK 


RP&>RPII 


14 


740Z 


UI9 


2 


74LS367 


UIS 




IZK RES. PACK 


RP5 


1 


74S37 


L113 


1 


74LS3k8 


UIOj26= 


5 


2.2K RES. PACK 


RPI 1 RP4>RP7,RP9 l RPI3 


7 





















































































A 


PROTOTVPt 














H 




>^ 




cs 








f. 


ECO 14-0043 PRE- PILOT Kit FASE 


M.G. 


>•&-» 










D 


ECO H-OIIS 


£.« 












E 


E^.O I4-032& 


■R.C 













I 1 1 M [ 




POWER jROLiMD AMD SPARE 3ATE LCX.ATER 



3EF. 
DE<=. 


DEVICE 
TYPE 


=>0'WE.R PiNS 








+ 12/ 




7400 


"7 


14 






Ui9 


"?402 


7 


14 






U 31 


74 OA 


i 7__ 


(4 






U24 


74 OS 
7432 


7 
7 


14 

"i'4" 






U2I 






Li 26, iO 


74 36 


7" 


14" 






U27 


74<bQ4 


7 


14 






U20 


74509 


7 


14 






UI3 


74537 


7 


14 






U'3, 5,8,9 


83C4B 


iO 


20 






.22,23 


74LS74 A 


7 


14 






un 


14L5I57 


8 


16 




UI4, 15,32 


74L5257 


& 


16 






U<b,i\ ,l2,lfc,i9,29 


74L530>7 


8 








UlO,2to 


74L<b3fa& 


e 


ICa 






UZ,7 


74L5374 


IO 


20 






U4 


SOSto-2 


i.ZO 


40 



































































































































































































































































162554-53 



J7-I4 , CLK-U/ 
Sh-l°i ,01TTL-V 



3ai , Qso-eo [aaT) — 



J3- IS , RDY-Y/ 
, READY- U/ 



J7-20, MMI-U/ 



74sy7 



+5V 



745 37 



' RPI1 



O.I 50V t 



1C\ , WOLD RQGTO-U/ [71- 



J3-I7 HLDA-Y/ 



1 , IMTR-U < 1 



74te"»><»7 

Uii. 



7AL536.7 



74L<r>^7 

uie 



74L63&I? 



141^13 
7AL«b%,8 



1*1 * I 



€>£E S HEET 



J PfT | CH< | DATE J tffKMtD 



■ — TaZT; ClKA , 7Bf 
1 > iLKA.JW 



8C»Cl_K-X,j5-ba 



• aso-x, JS--3S 



— (~Z~| R£ • Bfa , 3C5 

— > jREADv-v/.jb- 



• UMWII • V / : Ji -A 



— T51 M*-U/,?> AS, 5>Bft 



— TEH MlNSVb/^ca ,7C8 
-TF| HLDKRQGH-U/7CI 

-» MTR\ /,J2-7 



162554-54 




90 

a 

a 

s 

o 
00 

<■> 

53* 



162554-55 



o 
w 

(So 
On 

> 




162554-56 



. Ucll 



=7, ENUR$l\ [— 13 | y 



J2-^ , PULL UP CMD1/ « 



Ji-37,WRM\N/ «- 

JI-I4,DTR/ «e- 
J2-30, DEN/ 
3AI , LOCK-&<»/ 



. 3BI , SI- 
3BI i 61-84. 
3BI , S0-8fe 
Jl-14 > PLT CMDI 



2AI , MINSYS/[T)- 



JI-38 , ALE • 
3D I , IMTVL 
4.BI , BHEMlW/ji 
JZ.-3I RDCMD/ • 



•JAI ,050-66) AA - 
3Al,Q<3l -66 £B 
3BI,SSO-8<p/["t~ 



3AI.FLTCMDUZA [TQ- 

zbi , mmmx-u/[dT- 



J1- O . FLTCKAD2 



3M , A6l(c-8feTY~l— 
3 At ,A < an-8fe|n- 

3 At, AW-6»rvV 
661 , BHEX/[&iQ— 



7432 

UIO 

74LS3AS u2 4 



4r 740S 



>RP8 



Jrp4 

>2.2K £2,2K > 2.2K 

lie 



RPS 

2.2K 



our C/V7-RL 
SEL 



OUT CONTROL 
SEL 




^16 
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COUNT, 8-3, 8-6 

COUNT command, 8-3, 8-6 

CW Macro, 1-9 

DASM, 7-80, 7-89 

Data match range, 6-7 

Data segment register, 4-8, 7-15, 7-63 

Decode CAUSE command, 7-1, 7-65, 7-68 

DEFBLK Macro, 1-5 
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ELSE, 8-5 
EM, 8-9 

EMUL, 1-11,2-5 
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ENABLE/DISABLE EXPANSION command, 8-1, 8-12 
ENABLE/DISABLE RDY command, 6-25, G-l 
ENABLE/DISABLE SYMBOLICALLY command, 7-1, 
7-50, 7-60 

ENABLE/DISABLE TRACE command, 6-27, 6-36 
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EXIT command, 7-3, 7-6 
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ICE, 7-25 

ICE-86 and ICE-86A Emulators, 1 -2 
ICE-86A architecture, 1-10 
ICE-86A components, 2-1 
ICE-86A firmware, 1-11 
ICE-86A hardware, 1-11 
ICE-86A In-circuit emulation, 1-4 
ICE-86A In-circuit Emulator, 1-1 
ICE-86A software, 1-10 
ICE86 command, 7-3, 7-5 
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IF command, 8-5, 8-6 
IFL,4-10, 7-16, 7-64 
Implicit radix, 7-10 
INCLUDE, 8-16 
INCLUDE command, 8-16 
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INITOUT, 1-11,2-5 
INPUT, 6-7, 6-8 
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Installation Procedures for Intellec Series III Model 

286, 2-3 
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Instruction mode, 6-27 

Instruction pointer, 4-9, 7-15, 7-63 
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Integer, 5-1 
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INTELLEC, 7-24, 7-25 
INTERNAL, 4-15 
INTR, 4-11,7-16, 7-65 
Invoke Macro command, 8-8 
IP, 4-9, 7-15, 7-63 
IR, 4-11,7-16, 7-65 

Keyword references, 5-3 
Keywords, 4-7 

LENGTH, 6-6 

LINE, 7-53 

LIST, 7-4, 7-9 

LIST command, 7-4, 7-9 

LOAD, 7-3, 7-7 

LOAD command, 7-3, 7-7 

Local and global defaults, 8-9 

Logical operators, 5-1 1 

LOWER, 4-9, 7-15, 7-64 

MAC.TMP, 8-8 

MACRO, 8-8 

Macro commands, 8-8 

Macro Directory command, 8-13 

Macro expansion, 8-12 

Macro table commands, 8-12 

MAP DISK command, 7-24, 7-28 

MAP INTELLEC command, 7-24, 7-29 

MARK, 6-30 

MASK, 5-9,5-13 
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Match condition, 6-4 

Match condition restrictions, 6-8 

Match status list, 6-7, 6-8 

(MATCH0 OR MATCH 1)/, 1-11,2-5 

Memory and port contents, 4-15 

Memory mapping, 4-14 

Memory mapping commands, 7-24 

Memory references, 5-5 

MN, 4-11, 7-16, 7-65 

MN/MX, 4-11, 7-16, 7-65 

MNEMONIC, 6-30 

MOD, 5-9, 5-13 

Module name, 7-45 

MOVE, 6-27, 6-38 

MOVE command, 6-27, 6-38 

NESTING command, 7-78, 7-86 
Nesting compound command, 8-6 
NEWEST, 6-28, 6-38 
NEWEST command, 6-28, 6-38 
NMI, 4-11, 7-16, 7-65 
NOCODE, 7-3 
NOLINE, 7-3 

Non-execution match condition, 6-5, 6-10 
NOSYMBOL, 7-3 
NOT, 5-10, 5-11,5-13 

Notation and conventions used in this manual, 4-3 
Notational symbols, 4-3 
NOVERIFY, 7-25 
Number base, 5-2 

Number base and radix commands, 4-14, 7-10 

Numeric constant, 5-2 

Numeric value display formats, 7-65 
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OBJECT, 6-6 

OF, 7-46 

OFF, 6-36 

OFFSET, 5-9, 5-13 

OFFTRACE,6-12 

OFL,4-10, 7-16, 7-64 

OLDEST, 6-28, 6-38 

OLDEST command, 6-28, 6-38 

ON, 6-26 

ONTRACE,6-13 

OPCODE, 4-9, 7-15, 7-63 

OPCODE register, 4-9, 7-15, 7-63 

OPERANDS, 6-30 

Operands, 5-2 

Operating modes, 1-6 

Operators, 4-18, 5-8 

OR, 5-10, 5-12, 5-13 

ORIF, 8-5 

OUTPUT, 6-7, 6-8 

Partition, 6-6, 7-25, 7-29, 7-30, 7-32, 7-35 
Parenthesized expressions, 5-7 
Pathname, 7-2 
PFL,4-10, 7-16, 7-64 
PIN, 4-15 

Pin references, 4-11, 7-16, 7-65 
PIP, 4-9, 7-15, 7-63 
POINTER, 5-5, 5-11, 7-34, 7-66 
Pointer, 5-1 

Pointer and index file, 4-8, 7-15, 7-62 

Pointer registers, 4-8, 7-15, 7-62 

PORT, 5-7,5-11,7-40 

Port content references, 7-40 

Port reference, 5-1 1 

PREFIX, 6-30 

Previous instruction register, 4-9, 7-15, 7-63 

PRINT, 6-28, 6-39 

PRINT command, 6-28, 6-39 

Punctuation, 4-18 

PUT MACRO command, 8-14 

PUTBLK Macro, 1-6 

Q, 4-14 

QDEPTH, 6-30, 6-33 
QSTS, 6-29, 6-33. 

RAH, 4-8, 7-14, 7-62 
RAL, 4-8,7-14, 7-62 
RAX, 4-8, 7-14, 7-62 
RBH, 4-8, 7-14, 7-62 
RBL, 4-8, 7-14, 7-62 
RBX,4-8, 7-14,7-62 
RCH, 4-8, 7-14, 7-62 
RCL, 4-8,7-14,7-62 
RCX,4-8, 7-14, 7-62 
RDH,4-8, 7-14, 7-62 
RDL, 4-8,7-14, 7-62 
RDX, 4-8, 7-14, 7-62 
RDY, 4-1 1,7-16, 7-65 
READ, 6-7 

READY, 4-1 1,7-16, 7-65 

REAL, 4-15, 5-5, 5-6, 7-34, 7-66, 7-67, 7-69, 7-72 

Real data types, 4-15, 5-5, 5-6, 7-34, 7-66, 7-67, 7-69, 7-72 
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Registers, 4-7, 7-14, 7-61 

Relational Operators, 5-1 1 

REMBLK Macro, 1-6 

REMOVE MACRO command, 8-12 
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REPEAT command, 8-1, 8-6 
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RESET, 4-11, 7-16, 7-65 

RESET Domain command, 7-49, 7-59 

RESET HARDWARE command, 7-21 

RESET MAP command, 7-27, 7-33 

RF, 4-9, 7-15, 7-63 

RST, 4-11,7-16, 7-65 

RWTIMEOUT, 4-15, 6-24, G-3 

SAVE command, 7-4, 7-8 
Saving macros, 8-14 
SEGMENT, 5-9, 5-13 
Segment register file, 4-9, 7-15, 7-63 
Segment register usage, 6-8 
Segment registers, 4-9, 7-15, 7-63 
Semantic rules, 4-4, 5-13 
Set Breakpoint Register command, 6-15 
Set/change commands, 4-12 
Set CLOCK command, 6-23, G-l 
Set Domain command, 7-49, 7-58 
Set GO-Register (GR) command, 6-12, 6-20 
Set Input/Output Port Contents command, 7-40 
Set Map Status command, 7-25, 7-30 
Set Memory command, 7-34, 7-43 
Set memory and Port Contents commands, 7-34 
Set or Display Console Input Radix commands, 7-12 
Set or Display Console Output Radix commands, 7-13 
Set or Display RQ/GT command, 7-1, 7-14, 7-18, 7-20, 
7-65 

Set Register command, 7-20 

Set RWTIMEOUT command, 6-24, G-3 

Set TRACE Display Mode command, 6-27, 6-35 

Set Tracepoint Register command, 6-17 

Setting the GO Register, 6-12 

Setting memory contents, 7-34 

Setting tracepoint registers, 6-13 

SFL, 4-10, 7-16, 7-64 

SI, 4-8, 7-15,7-62 

Simple commands, 4-12 

SINTEGER, 5-5, 5-11, 7-3.4, 7-66 

Source index, 4-8, 7-15, 7-62 

SP,4-8, T-i5;7-62 

Special tokens, 4-18 

SS, 4-9,7-15, 7-63 

STACK, 7-77, 7-84 

STACK Macro, 1-6 

Stack pointer, 4-8, 7-15, 7-62 

Stack segment register, 4-8, 7-15, 7-63 

Statement number reference, 5-4 

Statement number table, 4-15 

Statement numbers, 4-17 

Statement references, 7-45 

Status bits, 4-10, 7-16,7-64 

STATUS Macro, 1-7 

Status registers, 4-9, 7-15, 7-63 

STEP command, 6-21 

STK Macro, 1-10 
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STKADDR Macro, Ml 
String constants, 5-7 
STS, 6-29, 6-33 
Suffix, 7-10 

SUFFIX, 4-14, 7-10, 7-12, 8-9 
SUFFIX command, 4-14, 7-10, 7-12, 8-9 
SW Macro, 1-9 
Symbolic debugging, 1-5 
Symbolic Display, 1-5, 7-1, 7-45 
Symbolic references, 7-45, 7-46 
Symbols, 4-17, 7-45 
Symbol table, 4-15 

Symbol Table and Statement Number Table 
commands, 4-15, 7-45 

T, 4-14 

TEST, 4-11,7-16, 7-65 
TFL,4-10, 7-16, 7-64 
THEN, 8-5 
TILL, 6-5, 6-12 

TIMER, 4-10, 6-13, 6-24, 7-15, 7-64 

TIMER register, 4-10, 6-13, 6-24, 7-15, 7-64 

TO, 6-6, 7-24 

Tokens, 4-6 

Trace buffer, 6-26 

Trace control, 4-16, 6-26 

Trace control commands, 4-16, 6-26 

Trace display formats, 6-29 

Trace display mode, 6-27 

Trace display restrictions, 6-28 

Trace references, 6-27 

Tracepoint registers, 6-13 

TREAL, 4-15, 5-5, 5-6, 7-35, 7-66, 7-67, 7-69, 7-73 
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TYPE command, 7-49, 7-57 
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Unary operators, 5-13 

UNTIL, 8-1, 8-2, 8-3 

UP, 6-7, 6-8 

UPPER, 4-9, 7-15,7-64 

USER, 7-24, 7-25 

User names, 4-17 

USING CS, 6-8 

USING DS, 6-8 

USING ES, 6-8 

USING SS, 6-8 

Utility commands, 4-13, 7-2 

WHILE, 8-1, 8-2, 8-3 
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WRITE, 8-17 
WRITE command, 8-17 
WRITTEN, 6-7, 6-8 

XOR, 5-10, 5-12, 5-13 

Y,4-14 

ZFL, 4-10, 7-16, 7-64 

8086 Pin references, 4-11, 7-15, 7-65 
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